一、安装打包工具

打开 CMD / PowerShell，执行：

pip install pyinstaller

二、基础打包命令

1. 最简打包（会弹出黑控制台窗口）

# -w 隐藏黑色命令行窗口（GUI程序必加，纯脚本不要加）
# -F 把所有依赖合并成单个exe文件
# -i 设置程序图标（.ico格式）
pyinstaller -F -w -i app.ico main.py

执行后目录生成 3 个文件夹：
build：打包临时缓存
dist：最终 exe 在这里
spec：打包配置文件

三、处理打包报错 / 依赖缺失

1. 第三方库打包不进去（比如 requests、opencv）

pyinstaller -F -w --hidden-import=requests main.py

2. 附带静态资源（图片、配置文件）

Windows 参数：--add-data "源路径;目标文件夹"
例：把项目里 assets 文件夹打包进去：

pyinstaller -F -w --add-data "assets;assets" main.py