Nuitka性能更好、体积更小？除了PyInstaller的另一个工具。

不知道大家刚开始学习python的时候，有没有这样的经历，想捣鼓做一些实用的小工具、脚本或者整蛊别人的小程序，但是我们都知道，电脑要想运行.py的文件需要提前安装python的解释器，不然运行不了。这时候就需要把.py的文件打包成可执行文件如exe，PyInstaller就是一个很好的工具，但是当自己试着去打包后发现文件好像挺大的，于是我又去搜了一下有没有更好的工具：

Nuitka 是一个将 Python 代码编译为原生二进制文件的工具，能显著提升性能并减小文件体积（相比 PyInstaller）。以下是详细的打包步骤，涵盖基础操作到进阶优化：

一、安装与配置

1. 安装 Nuitka

bash

2. 安装 C 编译器（关键步骤）

Nuitka 需要 C 编译器将 Python 代码转换为 C，再编译为二进制文件：

• Windows：安装 MinGW-w64 或 Microsoft Visual C++ Build Tools。
  • 推荐 MinGW-w64（路径无空格，避免编译错误）：

    bash

    	# 通过 Chocolatey 安装（管理员权限运行）
    	choco install mingw -y

• Linux/macOS：系统通常自带 gcc 或 clang，无需额外安装。

3. 验证安装

bash

二、基础打包命令

1. 打包简单脚本

bash

• --standalone：生成独立可执行文件（包含所有依赖）。
• --onefile：打包为单个 EXE（Linux/macOS 为单个二进制文件）。

2. 打包 GUI 程序（隐藏控制台）

bash

3. 指定输出目录

bash

三、进阶优化配置

1. 性能优化

• 启用优化编译：

  bash

  nuitka --standalone --onefile --optimize=2 your_script.py # 优化级别 0-2

• 使用多线程编译（加快速度）：

  bash

  nuitka --standalone --onefile --jobs=4 your_script.py # 使用 4 线程

2. 减小文件体积

• 链接时优化（LTO）：

  bash

  nuitka --standalone --onefile --lto=yes your_script.py

• 排除未使用的模块：

  bash

  nuitka --standalone --onefile --nofollow-imports=unnecessary_module your_script.py

3. 处理第三方库

• 强制包含模块（解决动态导入问题）：

  bash

  nuitka --standalone --onefile --include-module=hidden_dependency your_script.py

• 使用插件支持库（如 PyQt、NumPy）：

  bash

  nuitka --standalone --onefile --plugin-enable=qt-plugins your_qt_app.py

4. 调试与日志

• 生成详细日志：

  bash

  nuitka --standalone --onefile --debug your_script.py 2>&1 | tee build.log

• 禁用缓存（解决缓存冲突）：

  bash

  nuitka --standalone --onefile --no-cache your_script.py

四、完整打包示例（Windows + PyQt5）

1. 准备环境

bash

2. 编写测试脚本 (app.py)

python

3. 打包命令

bash

4. 验证结果

bash

五、常见问题解决

1. 编译错误：gcc: error: unrecognized command-line option

• 原因：编译器版本不兼容。
• 解决：
  • Windows 用户改用 MinGW-w64 或 MSVC 2019+。
  • Linux/macOS 用户升级 gcc/clang：

    bash

    	sudo apt install build-essential # Ubuntu
    	brew install gcc # macOS

2. 运行时缺失 DLL/SO 文件

• 原因：动态库未正确链接。
• 解决：
  • 手动指定库路径：

    bash

    nuitka --standalone --onefile --include-data-dir=C:/path/to/libs=. your_script.py

  • 或使用 --windows-dependency-tool=pefile（Windows 专用）。

3. 文件体积过大

• 优化方案：
  1. 启用 UPX 压缩（需单独安装）：

     bash

     nuitka --standalone --onefile --upx-dir=/path/to/upx your_script.py

  2. 排除非必要模块（如测试代码）：

     bash

     nuitka --standalone --onefile --nofollow-imports=tests your_script.py

4. 杀毒软件误报

• 原因：编译后的二进制文件特征类似恶意软件。
• 解决：
  • 添加代码签名证书（需购买）。
  • 提交误报样本到杀毒软件厂商（如 VirusTotal）。

六、性能对比（实测数据）

七、总结

1. 基础流程：安装 Nuitka + 编译器 → 编写脚本 → 运行 nuitka --standalone --onefile script.py。
2. 优化方向：
   • 性能：--optimize=2 --lto=yes --jobs=4
   • 体积：--upx-dir --nofollow-imports
   • 兼容性：--plugin-enable 支持特殊库
3. 调试技巧：通过 --debug 和日志定位问题。

通过合理配置，Nuitka 可生成比 PyInstaller 更小、更快的可执行文件，尤其适合商业软件或资源受限环境。