运行 Flet 应用 (热重载)

Flet 应用可以使用 flet run 命令以桌面应用或 Web 应用的形式执行。运行该命令将分别在原生操作系统窗口或 Web 浏览器中启动应用，并启用**热重载 (hot reload)**以实时查看代码更改。

桌面应用 (Desktop app)

要将 Flet 应用作为桌面应用运行，请使用以下命令：

uv

uv run flet run

pip

flet run

默认情况下，当您运行不带任何参数的命令时，将执行当前目录中的 main.py 脚本。

如果您需要提供不同的路径，请使用以下命令：

uv

uv run flet run [脚本]

pip

flet run [脚本]

其中 [脚本] 可以是您想要运行的 Python 脚本的相对路径（例如：counter.py）或绝对路径（例如：/Users/john/projects/flet-app/main.py）。

该应用程序将在原生操作系统窗口中启动：

macOS

Windows

---

Web 应用 (Web app)

要将 Flet 应用作为 Web 应用运行，请使用 --web（或 -w）选项：

uv

uv run flet run --web [脚本]

pip

flet run --web [脚本]

系统将打开一个新的浏览器窗口/标签页，且应用将使用一个随机的 TCP 端口：

---

监听更改 (Watching for changes)

默认情况下，Flet 会监视正在运行的脚本文件，并在修改并保存该文件内容时重新加载应用，但不会监视其他文件的更改。

若要修改此行为，您可以使用以下一个或多个 flet run 选项：

• -d 或 --directory：仅监视 [脚本] 所在目录中的更改。
• -r 或 --recursive：递归监视 [脚本] 所在目录及其所有子目录中的更改。

示例

uv

uv run flet run --recursive [脚本]

pip

flet run --recursive [脚本]