当前位置：物联沃-IOTWORD物联网 > 技术教程 > [Python]一文掌握Nuitka 参数语法详细介绍与示例
代码收藏家代码收藏家 技术教程

[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 提供了非常灵活和强大的参数配置，适合不同的打包需求。以下是一些常见的组合示例：

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

      nuitka --onefile script.py

    2. 使用 tkinter 插件生成 GUI 程序：

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

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

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

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

    作者：William数据分析

    物联沃分享整理
    物联沃-IOTWORD物联网 » [Python]一文掌握Nuitka 参数语法详细介绍与示例

    代码收藏家 普通

    分享到：

    相关推荐

    发表回复