如果你需要快速打包简单脚本选 PyInstaller，如果追求更小体积和更好代码保护选 Nuitka，但需要接受更长的编译时间和更复杂的环境配置。
先说结论：两者根本区别在于 PyInstaller 是打包器而 Nuitka 是编译器，选型取决于你对体积、速度、配置复杂度的优先级。
- 适合：PyInstaller 适合快速交付和简单项目，Nuitka 适合对体积和启动速度敏感的分发场景
- 重点看：PyInstaller 打包快但体积大，Nuitka 编译慢但产物优化好
- 别忽略：Nuitka 需要 C 编译器环境，动态导入和 eval 等特性支持有限，且单文件模式同样存在运行时解压开销
命令速用版
PyInstaller 基础打包命令：
pyinstaller `--onefile` `--windowed` main.py
Nuitka 基础编译命令：
python -m nuitka `--standalone` `--onefile` main.py
如果项目使用 PyQt/PySide，Nuitka 需要额外启用插件：
python -m nuitka `--standalone` `--enable-plugin`=pyside6 main.py
核心机制区别
PyInstaller 的工作方式是把 Python 解释器、你的代码、所有依赖库一起打包进一个文件。运行时它会先解压到临时目录，然后用内嵌的解释器执行字节码。这意味着你的代码本质上还是被解释执行的，没有真正的编译优化。
Nuitka 则是把 Python 代码转换成 C/C++ 代码，再调用系统编译器生成原生机器码。你的代码部分会被编译成二进制，第三方库可以选择性编译或保留为字节码。
注意：Nuitka 的 `--onefile` 模式在运行时同样会将文件解压到临时目录，这一点与 PyInstaller 类似。因此单文件模式的启动速度并不会比文件夹模式有显著提升，且同样受临时目录权限和空间影响。若追求极致启动速度，建议两者都优先测试文件夹模式（`--onedir` 或 `--standalone` 不带 `--onefile`）。
分步处理
第一步：评估项目类型
如果你的项目主要是调用第三方库，自己写的逻辑代码不多，Nuitka 的优化空间有限。如果项目有大量自定义计算逻辑，Nuitka 的编译优化更有价值。
第二步：准备环境
PyInstaller 只需安装 Python 包：
pip install pyinstaller
Nuitka 需要额外安装 C 编译器。Windows 上需要安装 MinGW 或 Visual Studio Build Tools，Linux 上需要 gcc，macOS 上需要 Xcode Command Line Tools。安装完成后验证：
python -m nuitka `--version`
第三步：首次打包测试
先用文件夹模式测试，确认程序能正常运行后再尝试单文件模式：
# PyInstaller 文件夹模式 pyinstaller `--onedir` main.py # Nuitka 文件夹模式 python -m nuitka `--standalone` main.py
运行生成的可执行文件，检查功能是否正常。
第四步：处理依赖和资源
如果有数据文件、配置文件需要打包，PyInstaller 使用 `--add-data` 参数，Nuitka 使用 `--include-package-data` 或手动拷贝到输出目录。
怎么验证是否生效
检查生成的可执行文件体积：
# Windows dir dist\main.exe # Linux/macOS ls -lh dist/main
测试启动时间，可以用系统自带的时间命令或手动计时。检查任务管理器中的内存占用情况。
验证程序功能是否完整，特别是涉及动态导入、插件加载的功能。如果有日志输出，检查运行日志是否有导入错误。
验证临时目录行为：对于单文件模式，可以在运行时监控临时文件夹（Windows 下通常为 %TEMP%），观察是否有解压产生的临时文件夹生成，确认运行时解压行为。
常见坑
Nuitka 编译时间明显长于 PyInstaller，大型项目可能需要数分钟甚至更久，不要误以为卡死。
动态导入（如 importlib.import_module）和 eval/exec 等动态代码执行，Nuitka 可能无法正确追踪依赖，需要手动指定 `--include-module` 或 `--include-package`。
某些第三方库与 Nuitka 兼容性不佳，编译后运行报错。遇到这种情况可以回退到 PyInstaller，或用 `--nofollow-imports` 让该库保持字节码形式。
PyInstaller 和 Nuitka 的单文件模式启动时都需要解压到临时目录，如果临时目录空间不足或权限有问题会导致启动失败。生产环境建议先测试文件夹模式，或确保目标机器临时目录权限正常。
代码混淆和反编译保护方面，Nuitka 生成的二进制文件确实比 PyInstaller 的字节码更难逆向，但不要指望完全防止反编译。
若 Nuitka 编译报错提示找不到编译器，请检查环境变量中是否已配置 gcc 或 cl.exe，重启终端后再次尝试。
参考来源
- PyInstaller 官方文档，PyInstaller Manual，https://pyinstaller.org/en/stable/
- Nuitka 官方文档，Nuitka User Manual，https://nuitka.net/doc/
- GitHub - pyinstaller/pyinstaller，https://github.com/pyinstaller/pyinstaller
- GitHub - Nuitka/Nuitka，https://github.com/Nuitka/Nuitka