本文介绍如何将含多级目录和资源文件的python项目可靠打包为windows可分发安装程序，推荐采用pyinstaller + inno setup组合方案，规避常见打包失败问题，生成专业、轻量、可静默安装的exe安装包。
本文介绍如何将含多级目录和资源文件的python项目可靠打包为windows可分发安装程序，推荐采用pyinstaller + inno setup组合方案，规避常见打包失败问题，生成专业、轻量、可静默安装的exe安装包。
在Python桌面应用或内部工具分发场景中，仅生成单个.exe往往不够——用户需要的是带图标、开始菜单快捷方式、注册表项、卸载支持及资源目录自动部署的完整安装体验。而直接使用pyinstaller --onefile或商业工具（如Advanced Installer）常因资源体积大、路径嵌套深或序列化异常（如 struct.pack() 错误）导致失败。此时，更稳健的实践是分两步构建：先用 PyInstaller 生成自包含可执行体，再用 Inno Setup 封装为功能完备的 Windows 安装程序。
✅ 第一步：用 PyInstaller 打包 Python 项目（含目录）
确保你的项目结构清晰，例如：
myapp/ ├── main.py ├── config/ │ └── settings.json ├── assets/ │ └── logo.ico └── requirements.txt
在项目根目录执行（推荐 --onedir 模式，避免 --onefile 的加载瓶颈和 struct.pack() 等序列化错误）：
pip install pyinstaller pyinstaller --onedir --name "MyApp" --icon=assets/logo.ico --add-data "config;config" --add-data "assets;assets" main.py
?
--add-data参数格式（Windows）：源路径;目标子目录，支持多次使用；
?--onedir生成dist/MyApp/文件夹，含所有依赖与资源，稳定性远高于--onefile；
? 若需控制启动控制台（如GUI应用隐藏黑窗），添加--windowed。
验证 dist/MyApp/ 能正常运行后再进入下一步。
立即学习“Python免费学习笔记（深入）”；
✅ 第二步：用 Inno Setup 制作专业安装包（EXE，非 MSI）
⚠️ 注意：Inno Setup 原生生成 .exe 安装程序（非 .msi），但其功能全面、体积小、兼容性极佳，且支持数字签名、静默安装（/VERYSILENT）、自定义页面与卸载集成，是多数Python项目的更优选择。若强制要求 .msi，可后续用 WiX Toolset 或 Advanced Installer 导入 Inno 生成的文件结构，但通常无必要。
- 下载并安装 Inno Setup（免费、开源、无体积限制）；
- 创建脚本文件
setup.iss（UTF-8 编码）：[Setup] AppName=MyApp AppVersion=1.0.0 DefaultDirName={autopf}\MyApp DefaultGroupName=MyApp OutputBaseFilename=MyApp_Installer Compression=lzma2 SolidCompression=yes
[Files] Source: "dist\MyApp*"; DestDir: "{app}"; Flags: ignoreversion recursesubdirs createallsubdirs
[Icons] Name: "{autoprograms}\MyApp"; Filename: "{app}\main.exe" Name: "{autodesktop}\MyApp"; Filename: "{app}\main.exe"
[Run] Filename: "{app}\main.exe"; Description: "Launch MyApp now"; Flags: nowait postinstall skipifsilent
3. 编译：右键 `setup.iss` → *Compile with Inno Setup*，输出 `MyApp_Installer.exe`。 ### ✅ 验证与发布 - 双击安装包，检查：安装路径、快捷方式、图标、卸载入口（控制面板 → 程序和功能）； - 在命令行测试静默安装：`MyApp_Installer.exe /VERYSILENT /SUPPRESSMSGBOXES`； - 如需升级，只需更新 `AppVersion` 并重编译，Inno 自动处理旧版本替换。 > ? 关键优势总结： > • PyInstaller `--onedir` 规避 `struct.pack()` 等底层序列化错误； > • Inno Setup 零成本、零体积限制、支持复杂部署逻辑； > • 比 Advanced Installer 更轻量，比纯 `--onefile` 更稳定可控； > • 全流程开源工具链，适合CI/CD集成（如GitHub Actions调用 `iscc.exe`）。 此方案已在数百个含配置目录、静态资源、数据库文件的Python项目中稳定落地，是兼顾可靠性、可维护性与专业交付体验的成熟路径。
