python打包工具Nuitka使用介绍

首先说一下，为什么我选择Nuitka而不是pyinstaller？

Nuitka相对pyinstaller有以下优点：

1. Nuitka能够对 Python 代码进行深度分析，并在此基础上生成优化后的 C 语言代码会针对生成的 C 代码进行更多的优化，这意味着生成的可执行文件可能运行得更快。

2. Nuitka对 Python 代码有更深入的理解，它可以更好地跟踪变量和优化代码，包括去除未使用的代码路径等。这有助于减小最终二进制文件的大小。

3. 增加反编译难度。Nuitka 将 Python 应用程序编译成 C 代码，并进一步编译成可执行文件时，最终生成的是一个类似于任何其他本地编译的应用程序的二进程文件。相比直接反编译 Python 字节码要困难得多。。

Nuitka 使用

要使用 Nuitka，首先需要安装 Python 环境，然后可以通过 pip 安装 Nuitka：

pip install nuitka

安装完成，你可以通过命令行来编译你的 Python 脚本。例如，如果你有一个名为 main.py 的脚本，可以使用以下命令来创建一个可执行文件：

nuitka main.py

然后会在当前目录下生成一个与 main.py 同名但扩展名为 .exe（Windows）或可执行文件（Linux/macOS）的文件。

这只是最简单的运行，Nuitka提供了丰富的参数，满足打包需求。

Nuitka 命令行参数

基础参数

• --standalone：启用独立模式输出。这意味着生成的二进制文件可以在没有预先安装 Python 的环境中运行。这通常会增加生成文件的大小，因为它会包含 Python 解释器和所有必需的库。
• --onefile：在独立模式的基础上，启用 onefile 模式。这会将所有内容打包成一个单独的可执行文件，而不是一个包含多个文件的文件夹。
• --show-progress：显示编译的进度信息。
• --show-memory：显示编译过程中内存的占用情况。

调试与日志

• --debug：使用 debug 版本的 Python 来编译代码。这有助于调试过程中的问题。
• --log-level=LEVEL：设置日志级别（如 INFO, WARNING, ERROR 等），以控制日志信息的详细程度。

导入控制

• --follow-imports：递归到所有导入的模块。在 --standalone 模式下默认开启。
• --follow-import-to=MODULE/PACKAGE：跟踪到指定的模块或包及其所有导入。
• --nofollow-import-to=MODULE/PACKAGE：即使使用了也不跟踪指定的模块或包。
• --include-package=PACKAGE：包含完整的包及其所有子模块。
• --include-module=MODULE：包含指定的单个模块。

插件与扩展

• --enable-plugin=PLUGIN：启用指定的插件。Nuitka 支持多种插件来扩展其功能，如 PyQt5 插件等。
• --plugin-enable=qt-plugins：特定于 Qt 插件的启用选项，用于包含 Qt 相关的动态链接库（DLL）等。

输出与文件控制

• --output-dir=DIR：指定输出目录，用于存放生成的可执行文件和其他相关文件。
• --onefile-tempdir-spec=SPEC：在 onefile 模式下，指定解压缩临时目录的规格。
• --windows-icon-from-ico=ICON：为 Windows 平台上的可执行文件指定图标文件。

编译优化

• --python-flag=FLAG：传递额外的 Python 标志给编译器，如 -O（优化模式）等。
• --no-prefer-source-code：对于已编译的扩展模块，如果同时存在源文件和扩展模块，则优先使用扩展模块。

其他

• --help：显示帮助信息并退出。
• --version：显示版本信息和提交 bug 报告所需的重要细节。

对于复杂的项目，可能需要根据项目的具体需求来选择合适的参数组合。例如，对于包含大量第三方依赖的项目，可能需要使用 --nofollow-import-to 参数来排除不需要编译的模块，以减少编译时间和生成文件的大小。同时，也可以结合使用 --include-package 和 --include-module 参数来确保关键模块被正确包含在内。

使用举例：

nuitka --standalone --windows-console-mode=disable --include-data-dir=./img=./img --include-data-dir=./data=./data --include-data-dir=./config=./config --windows-icon-from-ico=app.ico main.py

这个命令将 main.py 编译为一个独立的可执行文件，并且包含了一系列的额外数据文件目录，同时设置了应用程序图标，并且禁用了 Windows 控制台窗口的显示。然后会生成一个包含所有必需的资源和依赖项的独立可执行文件，可以在没有 Python 环境的计算机上运行。生成的可执行文件可以在 dist/ 目录下找到（默认输出目录）