Nuitka Tree Shaking：显式导入对Python打包exe体积的影响

核心结论 #

你不需要为了触发Tree Shaking减小体积，刻意把导入语句全改成显式指定单个对象的写法。
你提到的两种导入写法：

# 写法1：显式导入指定对象
from PySide6.QtGui import QPainter, QFontMetrics

# 写法2：导入整个子模块
from PySide6 import QtGui

在代码没有动态反射逻辑的前提下，最终编译出的.exe文件体积几乎没有差异，不会出现写法2比写法1大很多的情况。

原理说明 #

Nuitka的Tree Shaking是基于全链路静态分析实现的，不是简单扫描import语句的字面内容决定打包范围：

• 它会逐行追踪代码中实际被引用、调用的所有符号、对象，哪怕你导入了整个QtGui子模块，只要你的业务代码里从来没有访问过QPainter、QFontMetrics之外的其他QtGui成员，Nuitka会自动把未被引用的成员及其关联依赖全部裁掉，不会整包打包整个QtGui模块。
• 对PySide6这类绑定Qt框架的库，Nuitka还有专属的适配插件，会进一步裁掉未被使用的Qt插件、资源文件、翻译文件等大体积内容，这部分优化和你写哪种导入形式没有关联。

会导致体积出现差异的特殊情况 #

两种写法编译结果体积不一致，只会出现在静态分析失效的场景：

• 如果你的代码里用了动态属性访问、反射逻辑，比如写了getattr(QtGui, 动态生成的字符串变量)、QtGui.__dict__[xxx]这类Nuitka没法在编译期确定你要访问哪个成员的代码，为了保证程序运行不报错，Nuitka会被迫保留整个QtGui模块的全部内容，这时候写法2的编译体积会明显大于写法1。
• 如果导入的模块顶层代码存在强制加载依赖的副作用，只要你触发了这个模块的导入（不管是导入单个对象还是导入整个模块），这部分固定的依赖体积都会被计入，和导入写法无关。

实用优化建议 #

不用为了压缩体积刻意调整导入风格，真正能明显减小exe体积的操作优先级更高：

• 编译时务必加上--enable-plugin=pyside6参数，启用Nuitka对PySide6的专属优化
• 尽量避免对GUI模块、第三方大库用反射、动态属性访问的写法
• 按需开启--noinclude-*系列参数，明确排除你确定用不到的模块、资源

内容的提问来源于stack exchange，提问作者joshp