python pyinstaller 打包

一、核心基础

1. 安装

pip install pyinstaller  # 任意环境（系统/虚拟环境）均可安装

2. 打包核心逻辑

打包时，PyInstaller 会自动收集脚本依赖的库（当前环境下的）
生成独立文件，运行时无需 Python 解释器
优先使用虚拟环境打包（避免多余依赖，体积更小）

二、常用命令（最精简）

1. 基础格式

pyinstaller [参数] 脚本名.py

2. 必记参数

• -F 打包为单文件（所有依赖整合到一个 .exe） 方便分发（推荐）
• -w 窗口模式（无黑命令行窗口） GUI 程序（必加）
• -i 图标.ico 指定窗口图标（仅 Windows） 美化程序
• –name 自定义名 修改生成的 .exe 文件名 区分不同程序
• –clean 清理上次打包残留（避免冲突） 重新打包时使用
• -D 多文件模式（生成文件夹，含 .exe 和依赖） 启动速度更快

3. 高频示例（直接抄）

GUI 单文件 + 图标 + 自定义名：

pyinstaller -F -w -i ico.ico --name 我的工具 脚本.py

重新打包（清理残留）：

pyinstaller -F -w --clean 脚本.py

三、关键操作步骤

激活虚拟环境（可选但推荐）：

venv\Scripts\activate.bat  # Windows CMD

安装依赖（脚本必需 + pyinstaller）：

pip install ttkbootstrap pandas openpyxl pyinstaller

执行打包命令：

pyinstaller -F -w -i ico.ico tableprocess.py

找结果：
打包后生成 dist 文件夹，里面的 .exe 就是最终文件
多余文件（build、xxx.spec）可直接删除

四、常见问题（快速排查）

常见问题	解决方案
运行 .exe 弹黑窗口	打包时加 -w 参数
图标不显示	确保图标是 .ico 格式，路径和脚本同级
打包体积太大	用虚拟环境打包（仅装必需依赖）
报错 “缺少模块”	激活虚拟环境重新安装依赖
启动慢（单文件）	换 -D 多文件模式

五、核心总结

1. GUI 程序必加 -w，单文件分发必加 -F
2. 虚拟环境打包 = 体积更小 + 无多余依赖（推荐）
3. 打包后只需要 dist 里的 .exe（可单独复制使用）