Python打包编译工具Pyinstaller与Nuitka特性超详细对比

概要

当我们发布Python项目时，有时为了隔离运行环境的差异 或者 不希望以源码的形式发布，一种常用的方法是将Python项目打包/编译成二进制文件（更具体的讨论在Python项目加密 中），打包编译的工具有很多，其中PyInstaller 和 Nuitka 是目前最主流的两个工具。它们都能将 .py 文件打包成无需安装 Python 环境即可运行的二进制程序，但其底层机制、性能表现和适用场景存在显著差异。

结合实际的项目实践，本文从功能原理、特性异同、性能对比及实际选型建议等 详细对比 PyInstaller 与 Nuitka 的核心特性，供有需要的伙伴参考以项目需求做出更合理的技术选型。

简介

Pyinstaller

PyInstaller 是一个流行且成熟的 Python 打包工具，能Python 脚本及其依赖项（包括解释器、标准库、第三方包等）封装成单个可执行的二进制文件或目录结构。它通过分析字节码来静态追踪导入关系，并将所有必要资源捆绑到运行时环境中。

Nuitka

Nuitka （读作 努伊特卡） 是一个 真正意义上的Python 编译器，它将 Python 代码转换为优化的 C / C++ 代码，再通过gcc/msvc等编译链编译链接成可执行文件。

Python项目

提供一个Python Project，Python项目 SLOC (一个衡量项目源码量的指标——源码行数，统计时会刨除文档注释、空行、虚拟环境、非.py文件等无效因素影响) 2700+，属于中小型项目（一般代码量处于 1000~10000 的Python Project划分为中型项目），不含GUI相关依赖，文件结构形如：

| -- main.py				# 项目入口文件
| -- settings.py      		# 项目运行设置
| -- framework              # 项目核心
| -- basic					# 项目基础文件
| -- release				# 发布
| -- scripts				# 其他脚本
| -- cis				    # CI/CD相关
| -- venv				    # 项目虚拟环境

打包命令分别为：

# 执行下述命令前先cd到项目根目录下，并激活虚拟环境
# pyinstaller 与 nuitka 的安装均通过pip install直接安装即可，以Windows平台为例

# Pyinstaller
# 打包成单文件
pyinstaller -F main.py --workpath .\release\build --distpath .\release\output --clean --specpath .\release\windows
# 打包成单目录
pyinstaller -D main.py --workpath .\release\build --distpath .\release\output --clean --specpath .\release\windows
# ps: pyinstaller更常用的一种打包方式是指定.spec文件打包

# Nuitka
# 打包成单文件
nuitka --onefile --windows-console=disable --follow-imports --output-dir=.\release\output --clean-cache=all --lto=yes main.py
# 打包成单目录
nuitka --standalone --windows-console=disable --follow-imports --output-dir=.\release\output --clean-cache=all --lto=yes main.py
# nuitka 在打包时支持指定编译相关的特性，比pyinstaller更灵活

特性剖析

相同点

• pyinstaller与nuitka均支持单文件/单目录打包，单文件打包出来的二进制文件相对单目录更“紧凑”，但是在运行时单文件的内存开销与单目录不相上下，甚至反超；
• 单文件打包出来的二进制文件，运行时后台会同时驻留至少两个同名的进程（例如编译出来的是my_app.exe，启动后任务管理器里至少有两个my_app.exe 进程），其中一个内存开销明显比较小的是打包编译工具夹带的引导器（Bootstrap Loader），负责先把单文件解压到临时目录、设置运行环境（资源解压、环境管理、进程监控、权限管理等）后再启动真正的主进程。所以单文件产物运行时并非真正意义上的“单进程”。
• 单文件打包出来的产物如果运行中崩溃，并且使能了进程崩溃后自动重启将会反复在临时目录里解压资源，最后会把磁盘写爆，但单目录产物运行时完全不存在这种问题，因为它目录里放的本身就是解压后的内容，并且运行时不需要，所以相对单文件产物来说运行更稳定，如果不是为了分发方便，更推荐by 目录打包编译；
• 对于Python项目来说，只要安装了一个第三方模块，不管有没有在项目中import，都可能会影响到打包编译出来的固件大小，并且一般会使得打包编译的产物变大；（为什么是可能而不是一定，是根据第三方模块而定，像额外安装一个Cython就不会影响到打包编译出来的产物，但是安装airtest / numpy等就会有影响，即便在项目中没有用到）

差异点

• 不管是打包成单文件还是单目录，pyinstaller的打包过程都明显比nuitka快，从打包编译的原理上也好理解，后者多了一道 先转码再编译 的过程；
• Nuitka编译出来的产物（不管是单文件还是单目录，下同）理论上应该比Pyinstaller更精简，但是在笔者上面的示例项目中，nuitka编译出来的产物比Pyinstaller大了 ~1.5MB，经分析可能是因为项目并不是特别大，且不含GUI或者诸如OpenCV、paddleocr等大型第三方依赖，所以nuitka编译的优势没有体现出来；
• 上面提到单文件打包出来的固件运行时会先解压到临时目录，Pyinstaller解压到了C盘下的%TEMP%/_MEI* 目录，nuitka打包时允许自定义临时目录的位置，但是均解决不了崩溃后资源回收的问题；
• Pyinstaller打包出来的产物可以被反“打包”（可通过 pyinstxtractor 提取 pyc）反转码成Python源码，但nuitka几乎不可能实现反编译；
• nuitka编译出来的产物运行效率完爆Pyinstaller打包出来的产物；
• nuitka在打包编译的时候控制更灵活，可以控制编译行为，比如开启性能优化等；

最后来张对比图：

场景选型

• 小型项目（SLOC < 1000），快速交付验证：pyinstaller
• 中型项目（SLOC 1000~10000），带GUI / 图像处理 / 网络服务，
• 大型项目（SLOC > 10000），优选nuitka。

总之，如果更注重高性能、安全性、防逆向、运行时资源消耗小、商业化，优选nuitka；如果追求快速迭代、生态成熟稳定、兼容性好，优选pyinstaller。

总结

PyInstaller 与 Nuitka 代表了 Python 打包领域的两种哲学：

• PyInstaller 是“打包专家”——擅长整合现有资源，快速交付可用成果；
• Nuitka 是“编译先锋”——致力于将 Python 提升至系统级语言的执行效率。
  对于大多数开发者而言，PyInstaller 是首选入门工具；而对于追求性能、安全与专业形象的团队，Nuitka 正逐渐成为下一代标准。

技术选型没有银弹，只有最适合业务场景的选择。理解工具本质，方能游刃有余。

到此这篇关于Python打包编译工具Pyinstaller与Nuitka特性超详细对比的文章就介绍到这了,更多相关Python打包编译Pyinstaller与Nuitka内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！