PyInstaller 打包是将 Python 桌面应用交付给终端用户的核心环节。当开发完成一个 PyQt6 系统托盘工具后，开发者常面临\”如何生成独立可执行文件\”、“为何打包后闪退”、\”如何减小体积\”等实际问题。本文将提供一套经多平台验证的标准化方案，帮助你快速生成专业级分发产物。
为什么打包总失败？先理解 PyInstaller 的工作原理
盲目执行命令可能生成无法运行的产物。理解打包机制是成功交付的前提：
| 依赖分析 | 扫描 import 语句收集模块 | 动态导入未被识别，需 –hidden-import |
| 资源收集 | 打包 Qt 插件、图片、配置文件 | 路径硬编码导致运行时找不到资源 |
| 引导生成 | 创建解压 + 启动的 bootstrap 代码 | –windowed 缺失导致控制台闪烁 |
| 最终链接 | 合并为单文件或目录 | 杀毒软件误报、签名缺失 |
关键结论：80% 的打包问题源于依赖遗漏或路径配置错误，优先检查这两项可快速定位根因。
核心方案：单文件打包命令详解
基础命令：生成独立可执行文件
pyinstaller –onefile –windowed –icon=NONE –name=\”ServiceIndicator\” launcher.py
| –onefile | 合并所有依赖为单个 .exe 文件 | 分发友好，用户只需复制一个文件 |
| –windowed | 禁用控制台窗口（仅显示 GUI） | 托盘应用必备，避免后台黑窗 |
| –icon=NONE | 不使用额外图标（保留程序自绘外观） | 按需选择，纯色方块应用建议省略 |
| –name | 指定输出文件名（不含扩展名） | 提升产物专业度 |
输出位置：dist/ServiceIndicator.exe（Windows）
进阶配置：处理 PyQt6 动态导入
PyQt6 的插件系统采用运行时动态加载，需显式声明依赖：
pyinstaller –onefile –windowed –icon=NONE \\
–hidden-import=PyQt6.QtCore \\
–hidden-import=PyQt6.Qt
