3、PyInstaller高级选项：单文件与单目录打包、添加图标、隐藏控制台窗口、指定Python解释器版本

好，咱们继续往下走。上一节我们把PyInstaller的基础用法捋了一遍，说白了就是能跑起来、能打包。但实际项目中，光能跑远远不够。你想想看，给客户发一个黑乎乎的终端窗口，人家第一反应就是「这什么玩意儿？」。所以这一节，我重点聊聊那些真正让打包变得「专业」的高级选项。

3.1 单文件 vs 单目录：选哪个？

这是新手最容易纠结的问题。我刚开始用PyInstaller时，也觉得单文件多酷啊，一个exe甩过去多清爽。但后来在真实项目中吃过亏，才明白这里面门道不少。

单目录打包（-D，默认模式）

说白了就是生成一个文件夹，里面放着exe和一堆依赖的dll、pyd文件。这是PyInstaller的默认行为。

pyinstaller myapp.py  # 等价于 pyinstaller -D myapp.py

优点：

• 启动速度快。不需要解压，直接加载依赖
• 调试方便。出问题了能直接看到缺哪个dll
• 更新灵活。只替换exe文件就行，依赖库不用动

缺点：

• 分发麻烦。一个文件夹压缩包，用户还得解压
• 容易被误删。用户可能只把exe拷走了，结果跑不起来

单文件打包（-F）

把所有东西塞进一个exe里。启动时自动解压到临时目录，运行完再清理。

pyinstaller -F myapp.py

优点：

• 分发极简。一个文件，双击就跑
• 用户友好。尤其适合非技术用户

缺点：

• 启动慢。每次都要解压，大项目可能等好几秒
• 容易被杀软误报。单文件exe经常被当成病毒
• 调试困难。报错信息一闪而过，很难定位

3.2 添加图标：让应用有个「脸面」

默认的PyInstaller图标，嗯…怎么说呢，就是那个小火箭，看久了确实有点审美疲劳。给应用换个图标，其实花不了几分钟，但专业感提升不止一个档次。

pyinstaller -F -i app.ico myapp.py

这里有几个坑，我踩过，帮你列出来：

• 必须用.ico格式。png、jpg都不行，PyInstaller只认ico
• 图标尺寸要全。建议包含16x16、32x32、48x48、256x256这几个尺寸。否则在任务栏、桌面、文件夹里显示效果不一样
• 路径不要有中文。我遇到过中文路径导致图标加载失败的情况，后来全改成英文就没事了

3.3 隐藏控制台窗口：告别黑框框

这是GUI应用打包时的必修课。你写了个漂亮的PyQt或Tkinter界面，结果一运行，背后还跟着个黑乎乎的终端窗口，多掉价啊。

pyinstaller -F -w myapp.py  # -w 就是 --windowed 的缩写

加了 -w 参数后，控制台窗口就消失了。但这里有个细节要注意：

• GUI应用：必须加 -w，否则用户看到两个窗口
• 控制台应用：不要加 -w，否则输出信息全没了
• 调试阶段：我建议先不加 -w，等所有功能调通了再加。不然报错信息你看不到，排查起来很痛苦

3.4 指定Python解释器版本

这个选项说实话，日常用得不多。但一旦遇到兼容性问题，它就是救命稻草。

pyinstaller --python-version 3.8 myapp.py

什么场景下会用到？我举两个真实例子：

1. 多版本Python共存。你电脑上装了3.8和3.10，但某个库只支持3.8，这时候就需要显式指定
2. 虚拟环境打包。有时候虚拟环境里的Python版本和系统默认的不一致，PyInstaller可能找错解释器

不过说实话，我更推荐用另一种方式——直接指定Python解释器的完整路径：

pyinstaller -F --python-version 3.8 myapp.py

或者更直接一点，用虚拟环境里的Python来执行PyInstaller：

C:\Users\me\venv\Scripts\python.exe -m PyInstaller -F myapp.py

3.5 综合实战：一个完整的打包命令

说了这么多，咱们来一个实际项目中常用的组合命令。假设你有一个PyQt5写的桌面应用，叫 data_analyzer.py：

pyinstaller -F -w -i app.ico --add-data "config.json;." --hidden-import pandas data_analyzer.py

这条命令做了以下几件事：