[Python]一文掌握Nuitka 参数语法详细介绍与示例
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 --lto=yes script.py
通过灵活使用这些参数，你可以根据项目的需要调整打包策略，获得性能和体积的最佳平衡。