PyInstaller打包命令的核心功能是将Python脚本转换为独立的可执行文件,支持跨平台分发且无需用户安装Python环境。其关键亮点包括:一键生成单文件(-F参数)或目录结构(默认)、隐藏控制台窗口(-w参数)、自定义图标(-i参数)以及灵活添加数据文件(--add-data),满足从简单脚本到复杂GUI应用的全场景需求。
-
基础命令与安装
安装仅需pip install pyinstaller
,基础打包命令pyinstaller script.py
会生成包含可执行文件的dist
目录。若需单文件打包,添加-F
参数可合并所有依赖为一个可执行文件,大幅简化分发流程。 -
常用参数解析
- 界面优化:
-w
参数隐藏控制台窗口,适用于GUI程序;-i icon.ico
可指定应用图标,提升专业度。 - 资源整合:
--add-data "source:dest"
将配置文件、图片等非代码资源嵌入打包结果,路径分隔符需按操作系统选择(Windows用;
,Linux/macOS用:
)。 - 依赖处理:
--hidden-import
手动添加未自动检测的模块,如Pillow
的子模块需显式声明。
- 界面优化:
-
高级配置与调试
通过.spec
文件可深度定制打包流程,例如修改hiddenimports
列表或调整二进制文件路径。建议首次打包使用默认目录模式(-D
)测试功能,确认无误后再转为单文件模式(-F
)。 -
跨平台注意事项
图标格式需匹配系统(Windows用.ico
,macOS用.icns
),路径中避免中文或空格。若打包后程序报错,可检查warn-*.txt
日志排查缺失依赖,或使用sys._MEIPASS
动态定位资源路径。
提示: 生产环境推荐完整命令示例——pyinstaller -F -w --icon app.ico --add-data "config.json;." --hidden-import pandas script.py
,兼顾功能与用户体验。定期清理build
文件夹可避免旧缓存干扰新打包结果。