Flet 项目初始化文档
本文档详细介绍了在本地开发环境中创建 Python 虚拟环境并初始化 Flet 项目的完整步骤。
1. 虚拟环境创建
1.1 前提条件
- 已安装 Python 3.7 或更高版本
- 已安装 pip 包管理工具
1.2 创建虚拟环境
打开命令行终端，执行以下命令：
# 在项目目录中创建虚拟环境
python -m venv venv
这将在当前目录下创建一个名为 venv 的虚拟环境文件夹。
2. 虚拟环境激活与验证
2.1 激活虚拟环境
在 Windows 系统中，执行以下命令：
# 激活虚拟环境
.venv\Scripts\activate
激活后，命令行提示符前会显示 (venv) 前缀，表示虚拟环境已激活。
2.2 验证虚拟环境
执行以下命令验证虚拟环境是否正确激活：
# 查看 Python 版本
python --version
# 查看 pip 版本
pip --version
# 查看当前 Python 解释器路径
where python
3. Flet 库安装
在激活的虚拟环境中执行以下命令安装 Flet：
# 安装 Flet 库
pip install flet
这将安装最新版本的 Flet 库及其所有依赖项。
4. 使用 Flet 命令行工具初始化新项目
4.1 执行初始化命令
在激活的虚拟环境中执行以下命令：
# 初始化 Flet 项目
flet create
4.2 选择项目模板
执行命令后，Flet 会提示你选择项目模板。可以选择：
blank- 空白项目counter- 计数器示例todo- 待办事项示例gallery- 组件展示示例
4.3 项目命名
选择模板后，Flet 会提示你输入项目名称。输入一个有意义的名称，例如 my_flet_app。
4.4 等待初始化完成
Flet 会自动创建项目目录结构并安装必要的依赖项。初始化完成后，会显示成功信息。
5. 项目目录结构说明
初始化完成后，项目目录结构如下：
my_flet_app/
├── requirements.txt # 项目依赖文件
├── src/
│ └── main.py # 主应用文件
└── assets/ # 静态资源目录
requirements.txt- 包含项目依赖的列表src/main.py- 主应用代码，包含 Flet 应用的入口点assets/- 存放图片、字体等静态资源的目录
6. 运行初始项目
6.1 进入项目目录
# 进入项目目录
cd my_flet_app
6.2 运行项目
在激活的虚拟环境中执行以下命令：
# 运行 Flet 应用
python src/main.py
或者使用 Flet 命令：
# 使用 Flet 命令运行应用
flet run src/main.py
7. 常见问题及解决方法
7.1 Python 3.13 兼容性问题
问题：运行 flet create 时出现 TypeError: Plain typing.NoReturn is not valid as type argument 错误。
原因：Python 3.13 对 typing.NoReturn 的处理方式发生了变化，与旧版本的 outcome 包不兼容。
解决方法：
- 降级到 Python 3.12 或更低版本
- 等待
outcome包发布支持 Python 3.13 的新版本 - 在虚拟环境中安装最新版本的 Flet（0.84.0+），它使用了更新的依赖项
7.2 网络连接问题
问题：运行 flet create 时出现网络连接错误，如 ConnectionResetError。
原因：网络环境不稳定或防火墙限制。
解决方法：
- 检查网络连接
- 尝试使用代理服务器
- 手动创建项目结构并安装依赖
7.3 虚拟环境激活问题
问题：无法激活虚拟环境。
原因：命令路径错误或权限问题。
解决方法：
- 确保使用正确的路径
- 以管理员身份运行命令行
- 检查虚拟环境是否正确创建
8. 总结
通过以上步骤，你可以成功创建 Python 虚拟环境并初始化 Flet 项目。如果遇到问题，请参考常见问题及解决方法部分，或访问 Flet 官方文档获取更多帮助。
