本文详细对比了 PyInstaller、cx_Freeze、py2exe、py2app、Nuitka 及组合方案六种 Python 打包方式。涵盖安装配置、命令参数、跨平台兼容性、打包体积与运行性能等维度。针对隐式导入错误、多进程 GIL 锁限制等常见问题提供了解决思路，帮助开发者根据实际需求选择最优打包策略，实现代码的独立分发与基础保护。
Python 作为一种高级编程语言，具有易学易用、跨平台等优点，在开发中得到了广泛应用。然而，Python 是解释型语言，发布时通常意味着源码公开，且依赖环境配置。为了便于分发、保护源码或确保在没有安装 Python 环境的电脑上运行，将 Python 代码打包成独立的可执行文件（如 Windows 下的 .exe）是一种有效的解决方案。
本文将详细分析六种主流的 Python 打包方式，包括 PyInstaller、cx_Freeze、py2exe、py2app、Nuitka 以及组合方案，并探讨它们的优缺点及适用场景。
PyInstaller 是目前最流行的 Python 打包工具之一，支持将 Python 脚本及其依赖项打包成独立的可执行文件。
pip install pyinstaller
基本命令：
pyinstaller your_script.py
这将生成一个包含可执行文件和依赖资源的目录。若需生成单文件，可使用 --onefile 参数：
pyinstaller --onefile your_script.py
优点：
缺点：
cx_Freeze 是另一个成熟的打包工具，适合需要更精细控制打包过程的用户。
pip install cx_Freeze
通常需要编写 setup.py 配置文件来定义入口点和依赖：
from cx_Freeze import setup, Executable
setup(
name="MyApp",
version="1.0",
executables=[Executable("your_script.py")]
)
运行构建命令：
python setup.py build
优点：
缺点：
py2exe 是专为 Windows 平台设计的打包工具，适用于仅面向 Windows 分发的场景。
pip install py2exe
同样需要 setup.py 配置：
from distutils.core import setup
import py2exe
setup(console=['your_script.py'])
运行：
python setup.py py2exe
优点：
缺点：
py2app 是 macOS 平台专用的打包工具，用于将 Python 脚本转换为 Mac 应用程序。
pip install py2app
配置类似 py2exe，但针对 macOS 特性进行了优化。
优点：
缺点：
Nuitka 是一个 Python 编译器，它将 Python 代码编译为 C++ 代码，然后编译成机器码。这带来了显著的性能提升和安全优势。
pip install nuitka
基本命令：
python -m nuitka --standalone your_script.py
优点：
缺点：
结合 Nuitka 的编译能力和 PyInstaller 的打包灵活性，可以兼顾性能与分发便利性。
优点：
缺点：
PyInstaller 可能会遗漏动态导入的模块。例如使用 SQLAlchemy 连接数据库时，如果未显式导入驱动，打包后可能报错。
示例代码：
from sqlalchemy import create_engine
from sqlalchemy.orm import sessionmaker
DB_CONNECT_STRING = 'mysql+pymysql://root:<password>@localhost/study'
engine = create_engine(DB_CONNECT_STRING, echo=False)
DB_Session = sessionmaker(bind=engine)
session = DB_Session()
print('this is my test')
解决方案： 在代码中显式导入驱动库：
import pymysql
或者在打包命令中添加隐藏导入参数：
pyinstaller --hidden-import=pymysql your_script.py
CPython 存在全局解释器锁（GIL），限制了多线程利用多核 CPU 的能力。对于计算密集型任务，建议使用 multiprocessing 库开启多进程。
注意：
在多进程环境下打包时，需确保主入口函数被正确保护（如 if __name__ == '__main__':），否则可能导致子进程无限递归创建。PyInstaller 和 Nuitka 对此有特定的处理机制，建议参考官方文档配置。
| 工具 | 平台支持 | 性能 | 安全性 | 易用性 |
|---|---|---|---|---|
| PyInstaller | Win/Linux/Mac | 普通 | 低 | 高 |
| cx_Freeze | Win/Linux/Mac | 普通 | 低 | 中 |
| py2exe | Windows | 普通 | 低 | 中 |
| py2app | macOS | 普通 | 低 | 中 |
| Nuitka | Win/Linux/Mac | 高 | 高 | 中 |
| 组合方案 | Win/Linux/Mac | 高 | 极高 | 低 |
开发者应根据项目需求选择合适的打包方式。若追求快速开发和通用性，PyInstaller 是首选；若对性能和安全性有较高要求，Nuitka 更为合适。无论选择哪种方式，都应将 Python 代码打包成独立的可执行文件，方便用户使用。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online