本文分析了 Python 代码打包成可执行文件的六种主流方法：PyInstaller、cx_Freeze、py2exe、py2app、Nuitka 及组合方案。文章详细介绍了各工具的使用命令、配置示例及优缺点，涵盖跨平台支持、文件大小、启动速度、安全性等维度的对比。同时补充了隐式导入、多进程 GIL 锁、数据文件处理等常见问题的解决方案，帮助开发者根据实际场景选择合适的打包策略。
Python 作为一种高级编程语言，具有易学易用、跨平台等优点，在开发中得到了广泛应用。然而，Python 是解释型语言，运行依赖 Python 解释器环境。对于普通用户而言，安装 Python 环境可能较为繁琐；对于开发者而言，直接发布源码存在知识产权泄露风险。因此，将 Python 代码打包成独立的可执行文件（如 Windows 下的 .exe）成为一种常见的解决方案。
本文将详细分析六种主流的 Python 打包方式，包括 PyInstaller、cx_Freeze、py2exe、py2app、Nuitka 以及 Nuitka+PyInstaller 的组合方案，并探讨它们的优缺点及适用场景。
PyInstaller 是目前最流行的 Python 打包工具之一，支持跨平台（Windows、Linux、macOS）。它会将 Python 脚本及其依赖的库打包成一个独立的可执行文件或目录。
在命令行中输入以下命令：
pyinstaller your_script.py
这将生成一个 dist 文件夹，其中包含可执行文件。若希望生成单个文件，可添加 --onefile 参数：
pyinstaller --onefile your_script.py
--onefile: 打包为单个可执行文件。--windowed / -w: 不显示控制台窗口（适用于 GUI 程序）。--icon=icon.ico: 设置程序图标。--clean: 清理临时缓存文件。--spec: 指定或生成 .spec 配置文件，用于更复杂的打包逻辑。优点：
缺点：
cx_Freeze 是另一个成熟的打包工具，同样支持跨平台。它通过生成 setup.py 脚本来定义构建过程，适合需要自定义构建流程的场景。
首先安装 cx_Freeze，然后创建 setup.py：
from cx_Freeze import setup, Executable
build_options = {"packages": ["sqlalchemy", "pymysql"]}
setup(
name="MyApp",
version="1.0",
description="My Application",
options={"build_exe": build_options},
executables=[Executable("your_script.py")]
)
然后在命令行运行：
python setup.py build
优点：
缺点：
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
优点：
缺点：
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
优点：
缺点：
Nuitka 是一个 Python 编译器，它将 Python 代码编译成 C++ 代码，然后再编译成机器码。这种方式不仅能打包，还能提升性能并提供更好的代码保护。
nuitka --standalone your_script.py
优点：
缺点：
为了兼顾性能与兼容性，可以将 Nuitka 编译后的结果再交给 PyInstaller 打包。这种混合方案常用于对安全性和性能要求较高的商业软件。
nuitka --standalone your_script.py
优点：
缺点：
PyInstaller 有时无法自动检测到动态导入的模块。例如 SQLAlchemy 初始化时使用了 pymysql，但 PyInstaller 未识别。
解决方法： 显式导入相关模块，或使用 --hidden-import 参数：
pyinstaller --hidden-import=pymysql your_script.py
CPython 存在全局解释器锁（GIL），限制了多线程在多核 CPU 上的并行能力。对于计算密集型任务，建议使用 multiprocessing 库。
注意： 在使用 PyInstaller 打包多进程程序时，需确保入口函数被正确标记，避免递归打包错误。
如果程序依赖外部配置文件或图片，需将其添加到打包资源中。
PyInstaller 示例：
pyinstaller --add-data "data/config.ini;data" your_script.py
| 工具 | 平台支持 | 文件大小 | 启动速度 | 安全性 | 推荐场景 |
|---|---|---|---|---|---|
| PyInstaller | Win/Linux/Mac | 大 | 慢 | 低 | 通用分发，快速部署 |
| cx_Freeze | Win/Linux/Mac | 中 | 中 | 低 | 定制化构建需求 |
| py2exe | Windows | 小 | 快 | 低 | 老旧 Windows 项目 |
| py2app | macOS | 中 | 中 | 低 | macOS 原生应用 |
| Nuitka | Win/Linux/Mac | 大 | 快 | 高 | 高性能、防逆向需求 |
| Nuitka+Pyi | 全平台 | 极大 | 中 | 极高 | 商业级安全软件 |
选择合适的打包工具取决于具体的应用场景。如果是快速原型验证或内部工具，PyInstaller 是最便捷的选择；如果对性能和安全性有较高要求，建议考虑 Nuitka。无论选择哪种方式，都应在发布前进行充分的兼容性测试，确保目标环境能够正常运行。
开发者应根据实际需求权衡文件大小、启动速度和安全性，选择最合适的方案。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 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