Python中如何优化Py3.6 + PyQt5图形界面程序用pyinstaller打包生成的EXE体积过大问题

帖子内容是关于用PyInstaller打包PyQt5程序后EXE文件太大的问题。这确实是个常见痛点，尤其是PyQt5本身模块就很大。核心思路就是让PyInstaller只打包用到的部分，别把整个库都塞进去。

最直接有效的方法是在.spec文件里动手脚。创建spec文件后，在Analysis部分加入excludes和binaries参数来精减。下面是一个针对PyQt5的优化spec文件示例，你参考一下：

# -*- mode: python ; coding: utf-8 -*-

a = Analysis(
    ['your_script.py'],
    pathex=[],
    binaries=[],
    datas=[],
    hiddenimports=[],
    hookspath=[],
    hooksconfig={},
    runtime_hooks=[],
    excludes=[],  # 先留空，下面会具体填
    noarchive=False,
    optimize=0,
)

# 1. 排除肯定用不到的PyQt5子模块（根据你的实际使用情况调整）
pyqt5_excludes = [
    'PyQt5.QtWebEngine',
    'PyQt5.QtWebEngineCore',
    'PyQt5.QtWebEngineWidgets',
    'PyQt5.QtWebChannel',
    'PyQt5.QtNetwork',
    'PyQt5.QtSql',
    'PyQt5.QtTest',
    'PyQt5.QtAxContainer',
    'PyQt5.QtDesigner',
    'PyQt5.QtBluetooth',
    'PyQt5.QtPositioning',
    'PyQt5.QtSensors',
    'PyQt5.QtSerialPort',
    'PyQt5.QtWinExtras',
    'PyQt5.QtX11Extras',
    'PyQt5.QtMacExtras',
]
a.excludes.extend(pyqt5_excludes)

# 2. 排除其他可能用不到的大型库
other_excludes = [
    'numpy',  # 如果没用到的话
    'pandas',
    'scipy',
    'matplotlib',
    'PIL',    # 如果没用到Pillow
    'tkinter',
]
a.excludes.extend(other_excludes)

# 3. 关键一步：清理PyQt5的translations和qml文件夹，它们经常被误打包
# 找到PyQt5的安装路径，通常类似下面这样
import PyQt5
pyqt5_path = PyQt5.__path__[0]

# 从binaries列表中移除translations和qml（如果它们被自动加进去了）
# 更主动的做法是，在Analysis之后，直接去a.datas里删除相关条目
import os
translations_path = os.path.join(pyqt5_path, 'translations')
qml_path = os.path.join(pyqt5_path, 'qml')

# 遍历a.datas，移除包含这些路径的条目
a.datas = [item for item in a.datas if not (translations_path in item[0] or qml_path in item[0])]

pyz = PYZ(a.pure)

exe = EXE(
    pyz,
    a.scripts,
    a.binaries,
    a.datas,
    [],
    name='YourAppName',
    debug=False,
    bootloader_ignore_signals=False,
    strip=False,
    upx=True,  # 使用UPX压缩，效果显著
    upx_exclude=[],
    runtime_tmpdir=None,
    console=False,  # 如果是GUI程序
    disable_windowed_traceback=False,
    argv_emulation=False,
    target_arch=None,
    codesign_identity=None,
    entitlements_file=None,
    icon='your_icon.ico',  # 可选
)

coll = COLLECT(
    exe,
    a.binaries,
    a.datas,
    strip=False,
    upx=True,
    upx_exclude=[],
    name='YourAppName',
)

使用步骤：

1. 先生成初始spec文件：pyi-makespec your_script.py
2. 用上面的代码替换生成的spec文件内容，并根据你的实际情况调整（比如你的脚本名、排除的模块列表）。
3. 使用这个spec文件打包：pyinstaller your_script.spec

其他几个立竿见影的招儿：

• 换用更小的替代库：如果界面不复杂，可以考虑tkinter（内置）或PySide2/PySide6（官方说许可证更友好，有时打包后体积略小）。但如果是成熟项目，换库成本高。
• 终极方案：换打包工具：如果对体积极其敏感，可以研究下Nuitka。它把Python编译成C，然后再编译，理论上能生成更小更快的可执行文件，但配置更复杂，打包时间也更长。

总结建议： 核心是编辑spec文件，用excludes精准排除未使用的PyQt5子模块和大型依赖，并用UPX压缩。