本文介绍如何将包含多个文件和子目录的python项目可靠地打包为windows可分发安装程序，推荐采用pyinstaller + inno setup组合方案，规避常见打包失败问题，生成专业级安装包。
本文介绍如何将包含多个文件和子目录的python项目可靠地打包为windows可分发安装程序，推荐采用pyinstaller + inno setup组合方案，规避常见打包失败问题，生成专业级安装包。
将Python项目（尤其是含资源目录、配置文件、静态资产等多层级结构）直接打包为Windows安装程序（如 MSI 或 EXE 安装包），单靠单一工具往往难以兼顾完整性与稳定性。你提到使用 Advanced Installer 遇到文件体积限制，而 PyInstaller 报错 serialized_entry = struct.pack()，这通常源于字节码序列化异常——常见于过深嵌套、超大资源、损坏的 .pyc 文件或不兼容的 Python/PyInstaller 版本。
✅ 推荐工业级可行方案：分步构建 —— 先用 PyInstaller 生成独立可执行文件（.exe），再用 Inno Setup 封装为带向导、注册表、桌面快捷方式和卸载功能的安装程序（.exe 安装包）。
⚠️ 注意：Inno Setup 默认生成的是自解压安装程序（.exe），非 Windows 标准 MSI；如必须输出 .msi，可后续通过第三方工具（如 WiX Toolset）转换，但复杂度显著上升，且对 Python 应用兼容性较差——因此绝大多数桌面 Python 工具（如 PyCharm、AutoHotkey 发布版）均采用 Inno Setup 的 EXE 安装包形式，体验更稳定、用户接受度更高。
第一步：用 PyInstaller 打包为单文件可执行程序
确保项目结构清晰，例如：
myapp/ ├── main.py # 入口脚本（含 if __name__ == '__main__':） ├── resources/ │ ├── icons/ │ └── configs/ └── requirements.txt
在项目根目录执行（推荐 --onefile + --windowed + 显式指定资源路径）：
pip install pyinstaller pyinstaller --onefile --windowed --name "MyApp" --add-data "resources;resources" main.py
-
--add-data "resources;resources"表示将本地resources/目录复制到打包后运行时的resources/子目录（Windows 下分号分隔，Linux/macOS 用冒号）；立即学习“Python免费学习笔记（深入）”；
-
若需访问资源，请在代码中使用动态路径（避免硬编码）：
import sys import os def resource_path(relative_path): """获取资源绝对路径（兼容开发环境与 PyInstaller 打包后）""" try: base_path = sys._MEIPASS # PyInstaller 运行时路径 except AttributeError: base_path = os.path.abspath(".") return os.path.join(base_path, relative_path) icon_path = resource_path("resources/icons/app.ico")
第二步：用 Inno Setup 创建专业安装包
下载并安装 Inno Setup（免费、开源、文档完善）；
-
编写
setup.iss脚本（支持中文、图标、启动菜单、卸载集成）：[Setup] AppName=MyApp AppVersion=1.0.0 DefaultGroupName=MyApp OutputBaseFilename=MyApp_Installer Compression=lzma2 SolidCompression=yes [Files] Source: "dist\MyApp.exe"; DestDir: "{app}"; Flags: ignoreversion Source: "resources\*"; DestDir: "{app}\resources"; Flags: ignoreversion recursesubdirs [Icons] Name: "{autoprograms}\MyApp"; Filename: "{app}\MyApp.exe" Name: "{autodesktop}\MyApp"; Filename: "{app}\MyApp.exe" [Run] Filename: "{app}\MyApp.exe"; Description: "Launch MyApp now"; Flags: nowait postinstall skipifsilent 编译脚本：右键 → Compile, 输出
MyApp_Installer.exe即为双击即可安装的完整安装程序。
注意事项与最佳实践
- ✅ 始终在 干净虚拟环境 中测试打包流程，避免依赖污染；
- ✅ 使用
--onefile时，大型资源（如视频、模型权重）建议改用--onedir并配合--add-data，提升启动速度与调试便利性； - ❌ 避免在
main.py中直接读取os.getcwd()获取资源路径——务必使用resource_path()动态解析； - ? 如需数字签名，可在 Inno Setup 编译后使用
signtool签署.exe安装包，增强可信度； - ? 不强制要求 MSI：Windows 10/11 对
.exe安装包完全兼容，且 Inno Setup 支持静默安装（/VERYSILENT /SUPPRESSMSGBOXES）、日志记录、回滚机制，实际企业部署中更受青睐。
该方案经大量生产项目验证，稳定支持百MB级资源、多级嵌套目录及复杂依赖，是 Python 桌面应用交付的成熟路径。
