Nuitka 是一个 Python 编译器，它是目前 Python 打包成可执行文件（EXE）方案中，安全性（防反编译）和运行效率最高的工具之一。

与 PyInstaller 等传统打包工具相比，Nuitka 有显著区别：

在开始之前，你需要确保系统中安装了 Python 和 C++ 编译器。

直接使用 pip 安装：

pip install nuitka

Nuitka 需要 C++ 编译器将翻译后的代码编译成二进制文件。 * Windows: 推荐安装 MinGW64 或者 Visual Studio 2022 (MSVC)。

• 提示：首次运行 Nuitka 时，如果检测不到编译器，它通常会提示你自动下载 MinGW64，按照提示输入 ``yes`` 即可。

* Linux/macOS: 通常系统自带 GCC 或 Clang，无需额外配置。

假设你的入口文件是 main.py。

这是最稳健的模式，生成一个包含 EXE 和依赖文件的文件夹。

nuitka --standalone --show-progress --show-memory main.py

* –standalone: 独立环境，使程序可以移植到其他机器运行。 * –show-progress: 显示编译进度条。

生成单独的一个 EXE 文件，分发方便，但启动时需要解压，速度稍慢。

nuitka --standalone --onefile main.py

* –onefile: 启用单文件模式。

如果你开发的是 PyQt、Tkinter 等图形界面程序，不希望后台弹出黑色的 CMD 窗口。

nuitka --standalone --onefile --windows-disable-console main.py

* –windows-disable-console: 禁用 Windows 控制台。

nuitka --standalone --onefile --windows-icon-from-ico=app_icon.ico main.py

Nuitka 能够自动识别大多数库，但有时需要手动干预。

某些复杂的库（如 NumPy, PyQt, Tkinter）需要启用对应的插件才能正常工作。

# 示例：启用 Tkinter 和 NumPy 插件
nuitka --standalone --enable-plugin=tk-inter --enable-plugin=numpy main.py

查看所有可用插件：

nuitka --plugin-list

如果你的程序需要读取配置文件、图片等资源。

# 格式：--include-data-dir=源路径=目标路径
nuitka --standalone --include-data-dir=assets=assets main.py
 
# 或者包含单个文件
nuitka --standalone --include-data-files=config.ini=config.ini main.py

A: Nuitka 需要进行两次编译（Python → C++ → Binary），且会对代码进行静态分析和优化。第一次编译通常较慢，后续开启 –ccache 可以利用缓存加速。

A:

1. 确保使用了对应的插件（如 –enable-plugin=pyqt5）。
2. 使用 –follow-imports 强制跟随导入。
3. 检查是否是动态加载的库，尝试手动 import 隐藏的模块。

A: 使用 –onefile 模式生成的 EXE 偶尔会被误报。通常使用 MinGW64 编译比使用 MSVC 编译更容易被误报。建议向杀毒软件厂商提交白名单，或尝试不使用单文件模式（即只用 –standalone）。

为了获得最强的加密性和稳定性，推荐的生产环境命令组合：

nuitka --standalone --onefile \
       --windows-disable-console \
       --enable-plugin=pyside6 \
       --lto=no \
       --show-progress \
       main.py

注意：根据你的实际 GUI 框架修改 plugin 参数。