Nuitka 是一个非常强大的工具，它可以通过丰富的命令行参数自定义 Python 项目的编译过程。下面将详细介绍 Nuitka 常用的参数语法，并结合实际示例展示其使用。

1.基本参数

--standalone / --onefile

• 用途：创建一个可以独立运行的可执行文件，无需 Python 环境。
• --standalone：生成一个包含所有依赖的文件夹，里面有可执行文件和依赖。
• --onefile：将所有文件打包为一个单独的 .exe 文件，适合分发时使用。

示例：

• 生成一个单独的 .exe 文件：

nuitka --onefile script.py

• 生成包含可执行文件和依赖库的文件夹：

nuitka --standalone script.py

2.优化参数

--optimize=N

• 用途：优化生成的代码，N 是优化级别，可以是 0、1 或 2。数字越大，优化越多，但编译时间也会增加。

示例：

• 启用最大优化：

nuitka --standalone --optimize=2 script.py

--lto

• 用途：启用链接时优化（Link Time Optimization），进一步减少生成文件的大小并提升性能。

示例：

• 启用 LTO 以获得更小的文件体积和性能优化：

nuitka --onefile --lto=yes script.py

以下是 --lto 选项的可能值：

• --lto=no：禁用 LTO。这是默认值。
• --lto=yes：启用 LTO。这将进一步优化您的代码，但也会增加编译时间。
• --lto=thin：启用薄 LTO。这将比 --lto=no 优化您的代码更多，但不会像 --lto=yes 那样增加编译时间。

3.插件参数

Nuitka 提供了多个插件，用于扩展对特定库或特性的支持。例如 GUI 库、打包中的防膨胀（anti-bloat）插件等。

--enable-plugin=<plugin_name>

• 用途：启用指定的插件，支持多个插件，例如 tkinter、pyside、pyqt 等。

常见插件：

• tk-inter：支持 Tkinter GUI 程序。
• numpy：支持对 numpy 的优化打包。
• anti-bloat：减少无用模块的导入。
• no-qt：禁用 Qt 插件，避免膨胀。

示例：

• 启用 tkinter 插件来支持 Tkinter GUI：

nuitka --standalone --enable-plugin=tk-inter script.py

• 启用多个插件（tkinter 和 numpy）：

nuitka --standalone --enable-plugin=tk-inter --enable-plugin=numpy script.py

4.控制输出

--output-dir=<dir>

• 用途：指定编译输出目录。

示例：

• 将编译结果输出到 dist/ 目录：

nuitka --standalone --output-dir=dist script.py

--remove-output

• 用途：在编译完成后删除中间生成的 .c 文件和其他临时文件，节省磁盘空间。

示例：

• 删除临时文件以节省磁盘空间：

nuitka --standalone --remove-output script.py

5.处理依赖和导入

--nofollow-imports

• 用途：忽略所有模块的导入，不跟踪依赖。这可以减少生成文件的体积，但你需要确保所有必要的模块都被打包。

示例：

• 忽略所有导入，适用于无需动态导入的简单项目：

nuitka --standalone --nofollow-imports script.py

--include-package=<package_name> / --include-module=<module_name>

• 用途：显式包含某个模块或包，确保其被打包。如果某些模块没有被自动检测到，可以用此命令手动指定。

示例：

• 手动包含 my_package 包：

nuitka --standalone --include-package=my_package script.py

• 手动包含 my_module 模块：

nuitka --standalone --include-module=my_module script.py

--include-data-dir=<source>=<destination>

• 用途：将指定的文件夹打包到输出的可执行文件中，适用于需要将静态资源（例如配置文件、数据文件）包含到最终程序中的场景。

示例：

• 将当前目录下的 data/ 文件夹包含到可执行文件中：

nuitka --standalone --include-data-dir=./data=./data script.py

6.处理特定库的依赖

--noinclude-unittest

• 用途：排除 unittest 模块，减少不必要的测试框架的导入，可以减小文件体积。

示例：

• 排除 unittest 模块：

nuitka --standalone --noinclude-unittest script.py

--nofollow=<module_name>

• 用途：忽略指定模块的导入，不跟踪它的依赖。

示例：

• 不跟踪 logging 模块的导入：

nuitka --standalone --nofollow=logging script.py

7.控制二进制生成的配置

--python-flag=<flag>

• 用途：控制 Python 解释器的一些行为，例如启用优化模式或禁用断言。

常见标志：

• no_warnings：禁用 Python 警告。
• no_asserts：禁用断言语句，适合生产环境以提升性能。

示例：

• 禁用所有 Python 警告：

nuitka --standalone --python-flag=no_warnings script.py

• 禁用断言，适合优化生产环境的代码：

nuitka --standalone --python-flag=no_asserts script.py

8.编译器设置

--clang / --mingw64

• 用途：指定使用的编译器。Nuitka 默认使用本机的编译器，但你可以指定使用 Clang 或 MinGW64 等不同的编译器。

示例：

• 使用 clang 编译：

nuitka --standalone --clang script.py

• 使用 mingw64 编译（适用于 Windows）：

nuitka --standalone --mingw64 script.py

9.启用商业级特性

--commercial

• 用途：启用 Nuitka 的商业级功能，包括更高级别的优化和闭源项目支持。这个选项仅对 Nuitka 的商业版本有效。

示例：

• 启用商业级特性：

nuitka --standalone --commercial script.py

10.调试和日志

--debug

• 用途：启用调试模式，生成包含调试信息的可执行文件。适合在开发过程中跟踪和排查问题。

示例：

• 生成带有调试信息的文件：

nuitka --standalone --debug script.py

--show-scons

• 用途：显示内部 SCons 构建系统的输出，用于了解编译过程中的详细信息。

示例：

• 显示 SCons 的详细输出：

nuitka --standalone --show-scons script.py

总结

Nuitka 提供了非常灵活和强大的参数配置，适合不同的打包需求。以下是一些常见的组合示例：

• 最基本的打包（单文件可执行程序）：

nuitka --onefile script.py

• 使用 tkinter 插件生成 GUI 程序：

nuitka --onefile --enable-plugin=tk-inter script.py

• 启用优化和 LTO 以减少体积和提升性能：

nuitka --onefile --optimize=2 --lto script.py

通过灵活使用这些参数，你可以根据项目的需要调整打包策略，获得性能和体积的最佳平衡。