安装

本节将介绍如何安装 Flet 并进行环境配置。

前提条件

Python 版本

Flet 需要 Python 3.10 或更高版本。(1)

使用以下命令检查您的 Python 版本：

python --version

操作系统

macOS

Flet 支持 macOS 12 (Monterey) 或更高版本。

Windows

Flet 支持 64 位版本的 Microsoft Windows 10 和 Windows 11。

Linux

Flet 支持 Debian 10, 11 和 12，以及 Ubuntu 20.04, 22.04 和 24.04 LTS。

• 桌面环境（支持音频与视频）
• Windows Subsystem for Linux (WSL)

---

创建虚拟环境 (venv)

我们建议为您的 Flet 项目使用虚拟环境，以保持依赖项的隔离，避免与您的其他 Python 项目发生冲突。

首先，为您的 Flet 项目创建一个新目录并进入该目录：

mkdir my-app
cd my-app

接下来，创建并激活虚拟环境（我们推荐使用 uv 作为包管理器）：

uv

# uv 是“一个由 Rust 编写的极速 Python 包和项目管理器”。
# 如果您尚未安装 uv，请先安装它，然后运行以下命令：

uv init --python='>=3.10'
uv venv
source .venv/bin/activate

pip

# 使用 Python 自带的 venv 模块：
python -m venv .venv

# 激活虚拟环境：
# macOS/Linux
source .venv/bin/activate
# Windows
.venv\Scripts\activate

---

安装 Flet

要安装 Flet 并将其添加到项目依赖中，请根据您的包管理器执行以下操作：

uv

uv add 'flet[all]'

pip

pip install "flet[all]"

---

验证安装

为确保 Flet 已正确安装，我们可以使用 --version (或 -V) 标志或 doctor 命令来检查其版本：

uv

uv run flet --version
# 或
uv run flet doctor

pip

flet --version
# 或
flet doctor

现在，您已经准备好创建您的第一个 Flet 应用了。

---

升级 Flet

将 Flet 升级到最新版本：

uv

uv add 'flet[all]' --upgrade

pip

pip install "flet[all]" --upgrade