Nuitka打包后EXE超120MB？三招依赖裁剪实测

上个月给一个客户打包 PyQt5 写的运维工具，本地跑得好好的，Nuitka 命令行下去，出来一个 153MB 的 standalone 文件夹。客户在钉钉上问：“一个查日志的小工具，怎么这么大？” 我一看目录，光 Qt 的 dll 就塞了 90 多 MB，还有一整套 numpy 和 pandas 跟在后面——可程序里明明只用 pandas 读了个 CSV。这就是 Nuitka 打包最容易踩的坑：依赖收集太“耿直”，你的 import 哪怕只用了一个函数，它也可能把整个包连带间接依赖全卷进来。

一问：为什么 Nuitka 打包出来的 EXE 动不动就上百兆？

很多开发者会把 Nuitka 想成 C 编译器，以为编译完就跟 C 程序一样紧凑。其实 Nuitka 的编译更接近“把 Python 代码转成 C 再编译成 pyd/so”，运行时仍然需要 Python 解释器及大量动态库。默认 --follow-imports 模式会递归追踪所有 import，连同你根本没碰过的子模块都打包进去。像 PyQt5、numpy、scipy 这种体量惊人的库，哪怕你只用了一两个控件，整个 Qt 框架都会被拖进输出目录。这就是体积爆炸的根源。

二问：怎么快速揪出哪些依赖在“吃”体积？

最直接的办法是看 Nuitka 的构建日志。加上 --show-scons ，编译阶段会打出每个 .obj 和 .lib 的路径，可以大致判断哪些第三方包参与了链接。但日志刷屏太快，不好读。在「小辉 NuitkaGUI」里，打包完成后会有一个“依赖分析”面板，把 final 目录下的文件按来源包名分组，列出每个包占用的字节数。就拿前面那个例子，一点开就看见 PyQt5 占用 91MB，numpy 占用 33MB，而真正用到的 pandas 只有 11MB。这种可视化拆解能让大头依赖一目了然。

三问：怎么安全地砍掉不需要的依赖，又不让程序崩？

很多人上来就用 --nofollow-imports 粗暴阻止所有自动追踪，然后手动加 --include-module，这样很容易漏掉隐式依赖，运行时报一串 ModuleNotFoundError。更稳妥的做法是用「小辉 NuitkaGUI」里的深度依赖裁剪模块，它会解析 AST 找出代码里实际用到的 import，然后生成精确的包含/排除列表。拿刚才 153MB 的项目试了一次：排除掉 PyQt5.QtWebEngine、PyQt5.QtWebChannel 以及 numpy.testing 这些根本没用到的子包，配合 --noinclude-module=tkinter 把标准库里无关的 GUI 包也踢出，打包后体积降到 68MB。期间遇到过缺失 PyQt5.QtPrintSupport 导致打印功能报错，从日志里找到提示后，只把这一项重新 --include-module 补回来就解决了。裁剪后一定要完整跑一遍功能测试，尤其是涉及插件、动态导入的模块，踩坑概率较高。

除了砍依赖，还有什么压箱底的瘦身招？

依赖砍得差不多了，还可以用链接时优化 --lto=yes ，让 MSVC 在链接阶段做跨文件内联和死代码消除。小辉 NuitkaGUI 内置的 MSVC 编译器本身就比 MinGW 生成的代码略紧凑，开启 LTO 后通常还能缩小 10%~15%。如果还想再压一压，可以配合 --enable-plugin=upx 启用 UPX 压缩（需要电脑上装有 UPX 并加到 PATH）。对 68MB 的那个工具加 UPX 后，最终分发包压到了 42MB。但要注意，UPX 会脱壳执行，杀毒软件有时会误报，启动时也会多花零点几秒的解压时间，建议先不加 UPX 发一版给用户试用，没问题再压缩。

常见问题

Nuitka 打包后能不能用 UPX 压缩？会不会出兼容问题？

可以用，大多数 Windows 环境没问题。但确实有少数杀软对 UPX 加壳的可执行文件敏感，会直接隔离。推荐先用不加 UPX 的版本测试分发，确认没有误报后再启用。

我用 --standalone 打包体积很大，换成 --onefile 会变小吗？

--onefile 只是在 --standalone 外面再包一层自解压壳，实际 payload 体积不变，甚至因为解压引导代码而略大一点。瘦身的关键还是砍依赖、裁剪模块，与单文件或单目录模式无关。

裁剪后程序闪退，报错“ModuleNotFoundError: No module named 'xxx'”，怎么快速补回？

查一下 Nuitka 的输出日志或程序捕获的异常信息，确定缺失的模块名，然后用 --include-module=xxx 把它加回打包列表，重新构建一次即可。如果缺失的不止一个，建议分批补回，避免一次性加太多又把体积撑回去。