Python 脚本打包成 EXE 的 6 种主流方案对比与选型指南

常见问题处理

• 缺少模块：某些动态导入的库（如 numpy）需要手动指定 --hidden-import=numpy.core._methods。
• 数据文件丢失：使用 --add-data 参数，注意路径分隔符在 Windows 下是分号 ;。
• 杀毒误报：打包后的 exe 常被误杀，可尝试改用 --onedir 模式，或将样本提交给厂商白名单化。

2. auto-py-to-exe：图形界面，最适合新手

这本质上是 PyInstaller 的 GUI 封装。如果你不想记命令行参数，点点鼠标就能生成 exe，非常适合演示或快速交付给非技术用户。

pip install auto-py-to-exe
auto-py-to-exe

注意：在 Python 3.11+ 环境下偶尔会遇到兼容性问题，建议稳定版使用 3.9 或 3.10。

3. Nuitka：追求速度与保护代码的首选

Nuitka 会将 Python 代码先转译为 C，再编译成原生可执行文件。这意味着它不仅能提升运行效率，还能增加反编译的难度。

安装前需确保系统已配置好 C 编译器（如 MSVC 或 MinGW）：

pip install nuitka

推荐写法（单文件 + 插件）：

python -m nuitka --standalone --onefile \
    --enable-plugin=tk-inter \
    --windows-disable-console \
    --windows-icon-from-ico=app.ico \
    --include-data-dir=assets=assets \
    your_script.py

优势：

• 运行速度可达 CPython 的 2–4 倍，尤其在涉及 numpy/pandas/torch 等数值计算时。
• 启动速度通常比 PyInstaller 快很多。

代价：打包时间较长，复杂项目可能需要几分钟到十几分钟。

4. cx_Freeze：启动快、体积相对友好

cx_Freeze 适合对启动时间有要求的项目，且支持自定义 setup.py 配置。

pip install cx-freeze

创建 setup.py 配置：

from cx_Freeze import setup, Executable

setup(
    name="MyApp",
    version="1.0",
    executables=[Executable("main.py", base="Win32GUI")],
    options={
        "build_exe": {
            "packages": ["numpy", "pandas"],
            "include_files": ["config.json", "images/"],
            "excludes": ["tkinter"]  # 如不需要则排除
        }
    }
)

打包命令：

python setup.py build

优点在于目录结构清晰，启动比 PyInstaller 快；缺点是配置过程稍显繁琐。

5. PyOxidizer：极致启动速度 + 小体积

由 Rust 编写，嵌入了 Python 解释器。它更适合有 Rust 经验的开发者，或对启动时间、体积有极端要求的企业级项目。

配置文件示例 (pyoxidizer.bzl)：

[[python_distribution]]
name = "embedded"
python_exe = "python.exe"

[[exe]]
name = "myapp"
script = "main.py"

特点：启动极快、内存占用低、单文件体积小。但学习曲线陡峭，生态不如 PyInstaller 丰富。

6. Shiv / PEX：.pyz 格式，需目标机器有 Python

这不是真正的 EXE，而是打包为 .pyz 格式。如果目标机器没有预装 Python 环境，此方案不可用。

pip install shiv
shiv -c myapp -o myapp.pyz .

适用于内部工具分发或服务器端脚本，优点是文件很小且跨平台。

快速选择指南

根据实际需求，可以参考以下决策路径：

• 最简单、最快上手：auto-py-to-exe → PyInstaller
• GUI 程序、给普通人用：PyInstaller + --noconsole + --onefile
• 性能敏感、数值/AI 类程序：Nuitka（--onefile）
• 启动时间敏感：cx_Freeze 或 Nuitka
• 极致体积 + 启动速度：PyOxidizer 或 Nuitka
• 内部工具、服务器分发：Shiv / PEX

总结建议：先用 auto-py-to-exe 跑通流程，遇到问题后转 PyInstaller 命令行精细控制。如果对速度或代码保护有硬性要求，再切换至 Nuitka。