重装PyInstaller 4.4后dist文件夹过大含未使用依赖如何解决

问题核心原因 #

1. 你在spec文件中将整个venv/Lib/site-packages路径配置为了额外资源，这是最主要的问题。PyInstaller本身自带依赖扫描逻辑，会自动识别项目实际导入的依赖库，手动导入整个site-packages目录会把该路径下所有安装的库（包括你没用到的PyQt5、matplotlib等）全部打包进最终产物，导致体积暴涨。
2. 若你使用的是全局环境安装的PyInstaller，而非当前项目虚拟环境内的PyInstaller，也会导致PyInstaller扫描到全局环境安装的多余库，引入无关依赖。

解决方法 #

• 移除spec文件中venv/Lib/site-packages的额外资源配置，仅保留你自己项目需要的自定义资源（比如配置文件、静态资源等）即可，不需要手动导入依赖库目录。
• 打包前先激活当前项目的虚拟环境，确认使用的是虚拟环境内安装的PyInstaller，可执行以下命令验证路径：
  • Windows平台：where pyinstaller
  • Linux/macOS平台：which pyinstaller
    确认返回的路径指向你项目venv目录下的PyInstaller可执行文件。
• 清理历史打包产物，删除项目目录下旧的build、dist文件夹和spec文件，重新生成配置再打包：
  1. 生成新的spec文件：pyi-makespec 你的项目入口脚本名.py
  2. 若有自定义资源要添加，仅在新spec的datas参数中配置对应的资源路径，不要添加site-packages相关路径
  3. 执行打包：pyinstaller 你的spec文件名.spec
• 若仍有多余依赖残留，可在spec文件的excludes参数中手动指定要排除的库，示例配置如下：

a = Analysis(
    ['你的项目入口脚本.py'],
    pathex=[],
    binaries=[],
    datas=[], # 仅填写自定义资源，不要加site-packages
    hiddenimports=[],
    hookspath=[],
    hooksconfig={},
    runtime_hooks=[],
    excludes=['PyQt5', 'matplotlib'], # 此处添加需要排除的未使用库名
    win_no_prefer_redirects=False,
    win_private_assemblies=False,
    cipher=block_cipher,
    noarchive=False
)

• 额外体积优化：可使用UPX工具对打包产物进行压缩，配置UPX路径后打包命令示例：pyinstaller --upx-dir 你的UPX工具解压目录 你的spec文件名.spec

内容的提问来源于stack exchange，提问作者Jean-Luc BELLIER