Python 代码打包成可执行文件的六种主流方案及优缺点对比

然后在命令行运行：

python setup.py build

优缺点

优点：

• 灵活性强，可通过 setup.py 精确控制构建内容。
• 生成的文件通常比 PyInstaller 略小。
• 支持多入口点配置。

缺点：

• 配置相对复杂，新手上手难度稍高。
• 对某些动态库的支持不如 PyInstaller 完善。

3. 使用 py2exe

py2exe 是专为 Windows 平台设计的打包工具，可以将 Python 脚本转换为 Windows 可执行文件。

基本用法

需安装 py2exe 并编写 setup.py：

from distutils.core import setup
import py2exe

setup(
    options={"py2exe": {"bundle_files": 1, "compressed": True}},
    windows=[{"script": "your_script.py"}],
    zipfile=None
)

运行：

python setup.py py2exe

优缺点

优点：

• 针对 Windows 优化较好。
• 生成的 exe 文件体积较小。

缺点：

• 仅支持 Windows 平台。
• 已停止维护多年，对新版本 Python 支持不佳，不建议新项目使用。

4. 使用 py2app

py2app 是 macOS 平台上的标准打包工具，用于将 Python 应用打包为 .app 格式。

基本用法

类似 py2exe，需编写 setup.py：

from setuptools import setup

APP = ['your_script.py']
OPTIONS = {
    'argv_emulation': True,
    'plist': {
        'CFBundleName': 'My App',
        'CFBundleDisplayName': 'My App'
    }
}

setup(
    app=APP,
    options={'py2app': OPTIONS},
    setup_requires=['py2app'],
)

运行：

python setup.py py2app

优缺点

优点：

• macOS 原生体验好，符合系统规范。
• 支持签名和 notarization。

缺点：

• 仅支持 macOS 平台。
• 配置相对繁琐。

5. 使用 Nuitka

Nuitka 是一个 Python 编译器，它将 Python 代码编译成 C++ 代码，然后再编译成机器码。这种方式不仅能打包，还能提升性能并提供更好的代码保护。

基本用法

nuitka --standalone your_script.py

优缺点

优点：

• 性能提升：编译后的代码执行效率通常高于解释执行。
• 安全性高：源代码被编译为二进制，难以反编译还原。
• 无 GIL 限制：在某些情况下能更好地利用多核 CPU。

缺点：

• 编译时间长。
• 生成的文件体积较大。
• 对部分动态特性支持有限，可能需要调整代码。

6. 使用 Nuitka + PyInstaller 组合

为了兼顾性能与兼容性，可以将 Nuitka 编译后的结果再交给 PyInstaller 打包。这种混合方案常用于对安全性和性能要求较高的商业软件。

基本步骤

1. 使用 Nuitka 编译：

   nuitka --standalone your_script.py
   

2. 使用 PyInstaller 打包生成的 spec 文件或直接打包编译产物。

优缺点

优点：

• 结合了编译加速和打包便捷性。
• 安全性更高。

缺点：

• 流程复杂，调试困难。
• 兼容性问题较多，需谨慎测试。

常见问题与解决方案

1. 隐式导入问题

PyInstaller 有时无法自动检测到动态导入的模块。例如 SQLAlchemy 初始化时使用了 pymysql，但 PyInstaller 未识别。

解决方法： 显式导入相关模块，或使用 --hidden-import 参数：

pyinstaller --hidden-import=pymysql your_script.py

2. 多进程与 GIL 锁

CPython 存在全局解释器锁（GIL），限制了多线程在多核 CPU 上的并行能力。对于计算密集型任务，建议使用 multiprocessing 库。

注意： 在使用 PyInstaller 打包多进程程序时，需确保入口函数被正确标记，避免递归打包错误。

3. 数据文件缺失

如果程序依赖外部配置文件或图片，需将其添加到打包资源中。

PyInstaller 示例：

pyinstaller --add-data "data/config.ini;data" your_script.py

方案对比总结

结语

选择合适的打包工具取决于具体的应用场景。如果是快速原型验证或内部工具，PyInstaller 是最便捷的选择；如果对性能和安全性有较高要求，建议考虑 Nuitka。无论选择哪种方式，都应在发布前进行充分的兼容性测试，确保目标环境能够正常运行。

开发者应根据实际需求权衡文件大小、启动速度和安全性，选择最合适的方案。