PyQt5程序打包瘦身实战：从300MB到40MB的优化策略

1. 项目概述：为什么你的PyQt5程序打包后像个“臃肿的胖子”？

如果你用Python写过一个带图形界面的桌面应用，尤其是用了PyQt5这种强大的GUI库，最后用Pyinstaller打包成exe发给别人用，大概率会遇到两个让人头疼的问题：生成的exe文件体积巨大，动不动就几百兆；程序启动速度慢得像老牛拉车，双击后要等上好几秒甚至十几秒才能看到窗口。这感觉就像你精心设计了一辆跑车，结果交付时却装进了一个笨重的大集装箱里，启动还得先热半小时身。

我自己在开发工具软件时，一个简单的数据查看器，用Pyinstaller打包后竟然超过了300MB。用户反馈说：“软件挺好用，就是下载和打开太慢了。” 这直接影响了用户体验和软件的传播。问题的根源，其实就藏在Pyinstaller的打包机制和PyQt5这个“大家伙”里。Pyinstaller为了保证你的程序在任何Windows电脑上都能运行，默认会把你整个Python环境、所有已安装的库（包括你可能只用了一小部分的PyQt5）以及各种依赖的动态链接库（DLL）全部“塞”进一个文件夹或单个exe里。而PyQt5本身就是一个功能完备的GUI框架，包含了QtCore、QtGui、QtWidgets等众多模块，以及海量的图标、翻译文件等资源，体积自然小不了。

所以，这个项目的核心目标非常明确：在保证程序功能完全正常的前提下，通过一系列技术手段，对Pyinstaller打包PyQt5应用的过程进行“瘦身”和“加速”。最终目的是得到一个体积小巧、启动迅速、便于分发的可执行文件。这不仅是一个优化问题，更直接关系到你开发的软件是否具备良好的用户体验和产品竞争力。无论你是独立开发者，还是为公司内部开发工具，掌握这套优化流程都至关重要。

2. 打包臃肿的根源深度剖析

要解决问题，必须先透彻理解问题是如何产生的。Pyinstaller打包后体积大、启动慢，是多个因素共同作用的结果，我们可以从打包过程和运行时行为两个层面来拆解。

2.1 Pyinstaller的“全家桶”式打包机制

Pyinstaller的工作原理，可以理解为创建一个独立的、迷你版的Python运行环境。当你执行pyinstaller -F -w your_script.py这样的命令时，它会做以下几件事：

1. 依赖分析：通过分析你的your_script.py以及所有import语句，递归地找出所有需要导入的模块。
2. 收集文件：将这些Python模块（.py或.pyc文件）、以及这些模块所依赖的二进制扩展（.pyd文件）、动态链接库（.dll文件）、数据文件等，全部收集起来。
3. 打包封装：将收集到的所有文件，连同一个轻量化的Python解释器，一起封装进最终的输出目录（dist）或单个exe文件中（使用-F参数时）。

这里的关键在于依赖分析是保守的。例如，你只从PyQt5.QtWidgets中导入了QApplication和QMainWindow，但Pyinstaller为了保证万无一失，可能会把整个PyQt5包，甚至是你环境中安装的其他无关库（如果存在隐式依赖或路径被意外包含）都打包进去。特别是PyQt5，它不是一个单纯的Python包，其背后是庞大的C++ Qt库，这些二进制文件是体积的主要贡献者。

2.2 PyQt5：功能强大背后的“重量级”依赖

PyQt5是Python对Qt5库的完整绑定。Qt本身是一个跨平台的C++应用程序框架，功能极其丰富。当你安装PyQt5时，实际上安装了两大部分：

• Python绑定模块：即PyQt5目录下的那些.py和.pyd文件。这部分体积相对可控。
• 底层的Qt5共享库：大量的.dll文件（Windows下），通常位于Python安装目录的Lib\site-packages\PyQt5\Qt5\bin或其子目录中。这些DLL提供了GUI渲染、网络、多媒体、数据库连接等所有核心功能。
• 资源文件：包括图标集（.qrc编译后的 .rcc 文件）、各国语言翻译文件（.qm）、Qt插件等。例如，qt.conf、translations文件夹等。

默认打包时，Pyinstaller往往会将整个PyQt5目录及其关联的Qt库全部纳入，即使你的程序只用到了其中10%的功能。例如，你的程序根本不涉及多媒体播放，但Qt5Multimedia.dll这个大家伙依然会被打包进来。

2.3 动态链接库加载与启动延迟

启动慢的罪魁祸首，在单文件打包模式（-F）下尤为明显。-F参数会将所有文件压缩进一个exe中。运行时，这个exe会先在系统临时目录（如C:\Users\用户名\AppData\Local\Temp\_MEIxxxxxx）解压出所有文件，然后再启动Python解释器执行你的脚本。这个解压过程是IO密集型的，文件越多、越大，耗时就越长。

即使不使用-F参数，生成一个文件夹，程序启动时操作系统也需要加载大量的DLL到内存中。PyQt5/Qt的DLL数量众多，且可能存在复杂的依赖关系，逐一加载和链接也会消耗可观的时间。此外，Python解释器自身初始化、导入你的主模块及所有依赖模块（尤其是编译大型的.pyd文件），都是CPU和IO操作，共同导致了启动时的“漫长等待”。

3. 核心瘦身与加速策略全解

理解了根源，我们就可以有的放矢，从“减少打包内容”和“优化启动流程”两个方向制定策略。下面这套组合拳，是我经过多个项目实战总结出的有效方法。

3.1 策略一：精准控制Pyinstaller的打包范围

这是最直接、效果最显著的瘦身方法。核心思想是告诉Pyinstaller：“只打包我明确需要的，别的都不要。”

3.1.1 使用--exclude-module排除无关模块

在Pyinstaller命令中，可以使用--exclude-module参数排除那些被自动分析进来、但实际未使用的标准库或第三方库。对于PyQt5应用，一些常见的排除项包括：

pyinstaller --exclude-module PyQt5.QtWebEngine \ --exclude-module PyQt5.QtMultimedia \ --exclude-module PyQt5.QtBluetooth \ --exclude-module PyQt5.QtNfc \ --exclude-module PyQt5.QtSensors \ --exclude-module PyQt5.QtSerialPort \ --exclude-module PyQt5.QtSql \ --exclude-module PyQt5.QtTest \ --exclude-module PyQt5.QtXml \ -w your_script.py

如何确定要排除哪些模块？

1. 检查你的代码：确保没有任何import这些模块的语句。
2. 打包后分析：先进行一次普通打包，查看生成的your_script.spec文件，或在build\your_script\Analysis.toc文件中，找到pure列表，里面列出了所有将被打包的Python模块。从中识别出明显不需要的PyQt5子模块。

注意：过度排除可能导致运行时缺失模块而崩溃。建议从最可能不需要的模块（如WebEngine、Bluetooth）开始排除，打包后进行充分的功能测试。

3.1.2 编写.spec文件进行高级配置

对于复杂的项目，直接使用命令行参数会非常冗长且难以维护。Pyinstaller允许我们使用.spec文件来定义完整的打包流程。首先生成一个基础spec文件：pyi-makespec -w your_script.py，然后编辑your_script.spec。

在Analysis部分，我们可以进行更精细的控制：

# your_script.spec a = Analysis(['your_script.py'], pathex=[], binaries=[], datas=[], hiddenimports=[], hookspath=[], runtime_hooks=[], excludes=['PyQt5.QtWebEngine', 'PyQt5.QtMultimedia', 'PyQt5.QtBluetooth'], # 在此处排除模块 win_no_prefer_redirects=False, win_private_assemblies=False, cipher=None, noarchive=False)

使用spec文件后，打包命令简化为：pyinstaller your_script.spec

3.1.3 利用datas和binaries精确控制资源文件

在spec文件的Analysis或EXE部分，datas和binaries变量用于手动添加数据文件和二进制文件。反过来，我们也可以利用这个机制，只添加必要的文件，而不是让Pyinstaller自动抓取整个包。

首先，我们需要知道PyQt5运行时最小需要哪些文件。一个典型的、仅使用基础Widgets的PyQt5程序，至少需要以下Qt5 DLLs（具体名称可能因版本略有差异）：

• Qt5Core.dll
• Qt5Gui.dll
• Qt5Widgets.dll
• 以及它们依赖的一些系统库，如icu*.dll,opengl32sw.dll(如果用到OpenGL) 等。

我们可以修改spec文件，移除自动收集的二进制文件，然后手动添加必需的：

# ... 在 Analysis 块之后，PYZ 块之前 ... # 首先，清空或过滤自动收集的binaries（这是一个高级操作，需谨慎） # 更常见的做法是，在 COLLECT 步骤（生成文件夹时）或 EXE 步骤（生成单文件时）后，手动清理dist目录。 # 但我们可以通过hook来影响收集过程，不过更直接的方法是“先打包，后手动删除”。 # 假设我们采用“先打包后清理”的策略，这里主要展示datas的用法，比如添加必要的图标和翻译文件： a.datas += [('my_app_icon.ico', '.', 'DATA')] # 添加自定义图标 # 如果你使用了Qt的翻译系统，需要添加.qm文件 # a.datas += [('translations/zh_CN.qm', 'translations', 'DATA')]

更常见的做法是：先用默认配置打包到文件夹（不用-F），然后手动进入dist/your_app目录，删除明显不需要的PyQt5子模块目录（如PyQt5/Qt/plugins/mediaservice）和DLL文件。记录下删除后仍能正常运行的文件列表，最后利用这个列表来配置datas和binaries，实现精准打包。这是一个迭代和测试的过程。

3.2 策略二：优化PyQt5本身的引入方式

代码层面的优化，能从源头上减少不必要的依赖。

3.2.1 惰性导入与条件导入

不要在文件顶部一股脑地导入所有可能用到的PyQt5模块。采用按需导入（惰性导入）的方式。

# 不推荐：顶部全部导入 from PyQt5.QtWidgets import QApplication, QMainWindow, QPushButton, QLabel, QVBoxLayout, QHBoxLayout, QFileDialog, QMessageBox from PyQt5.QtCore import Qt, QTimer, QUrl from PyQt5.QtGui import QIcon, QPixmap # 推荐：在函数内部或类方法中按需导入 def open_file(self): # 只有当用户点击打开文件时，才导入QFileDialog from PyQt5.QtWidgets import QFileDialog file_name, _ = QFileDialog.getOpenFileName(self, "打开文件") if file_name: self.load_file(file_name) def show_about(self): # 关于对话框可能不常用 from PyQt5.QtWidgets import QMessageBox QMessageBox.about(self, "关于", "这是一个优化后的程序")

对于某些可选功能，可以使用条件导入。

# 假设图表功能是可选的，依赖matplotlib def plot_data(self, data): try: import matplotlib.pyplot as plt from matplotlib.backends.backend_qt5agg import FigureCanvasQTAgg # ... 绘图代码 ... except ImportError: from PyQt5.QtWidgets import QMessageBox QMessageBox.warning(self, "功能不可用", "请安装matplotlib以使用图表功能")

Pyinstaller的静态分析工具在解析你的代码时，可能无法探测到在函数内部或条件分支里的import语句。因此，如果你使用了惰性导入或条件导入，Pyinstaller可能不会自动包含这些模块，导致运行时出错。此时，你需要在spec文件或命令行中使用--hidden-import参数来显式告诉Pyinstaller这些隐藏的依赖。

pyinstaller --hidden-import PyQt5.QtWidgets --hidden-import matplotlib.pyplot your_script.py

或者在spec文件中：

a = Analysis(..., hiddenimports=['PyQt5.QtWidgets', 'matplotlib.pyplot'], # 添加隐藏导入 ...)

3.2.2 避免使用from PyQt5 import *

这种通配符导入方式会让代码分析工具（包括Pyinstaller和IDE）难以确定你到底使用了哪些子模块，极易导致打包进整个PyQt5。务必使用显式导入。

3.3 策略三：启用UPX压缩与优化编译选项

3.3.1 使用UPX压缩可执行文件

UPX (Ultimate Packer for eXecutables) 是一款开源的可执行文件压缩工具，能显著减小exe和dll的体积。Pyinstaller可以集成UPX。

1. 下载UPX：从 UPX官网 下载对应你操作系统的版本，解压到一个目录，例如C:\upx。
2. 让Pyinstaller使用UPX：
   • 命令行：pyinstaller --upx-dir=C:\upx -w your_script.py
   • spec文件：在EXE或COLLECT步骤的构造函数中传入upx_dir参数，但更简单的方式是确保UPX在系统PATH环境变量中，或者通过命令行指定。

使用UPX通常能将最终可执行文件的体积压缩30%-50%，甚至更多。但需要注意：

• 杀毒软件误报：压缩加壳行为可能被一些敏感的杀毒软件标记为可疑。对于公开发布的软件，需要做好测试和说明。
• 轻微启动延迟：UPX压缩的文件在运行时需要先在内存中解压，这会增加极短的启动时间（通常毫秒级），但相比于从巨大体积中解压文件，这个代价是值得的。

3.3.2 使用--strip参数（Linux/macOS）和优化标志

• --strip(主要适用于Linux/macOS)：移除二进制文件（如Python解释器、.so库）中的调试符号，可以减小体积。Windows下Pyinstaller默认会进行类似优化。
• --noupx：如果你不想使用UPX（例如为了避免误报），可以显式禁用。
• Python编译优化：在打包时，可以设置Python的优化环境变量，移除断言语句和文档字符串（对体积影响较小）。pyinstaller -O -w your_script.py中的-O标志会设置PYTHONOPTIMIZE，但主要影响的是你的源代码.pyc文件，对第三方库的已编译.pyd文件无效。

3.4 策略四：虚拟环境与最小化依赖管理

一个混乱的全局Python环境是打包体积大的温床。你可能在开发过程中无意中安装了许多与项目无关的库，而Pyinstaller可能会把它们一并打包。

3.4.1 为项目创建纯净的虚拟环境

使用venv或conda为每个PyQt5项目创建一个独立的虚拟环境。

# 使用 venv python -m venv venv_my_qt_app # 激活 (Windows) venv_my_qt_app\Scripts\activate # 激活 (Linux/macOS) source venv_my_qt_app/bin/activate

3.4.2 在虚拟环境中仅安装必要依赖

激活虚拟环境后，使用pip精确安装项目所需的包。

pip install pyqt5 pip install pyinstaller # 其他必要的库，如 pandas, numpy, openpyxl 等，按需安装

使用pip freeze > requirements.txt生成依赖清单。在干净的虚拟环境中，用pip install -r requirements.txt即可复现完全相同的环境。这确保了打包时引入的依赖是最小集合。

3.5 策略五：放弃单文件打包，采用文件夹分发

如果对启动速度极其敏感，且不介意分发一个文件夹而非单个exe，那么放弃-F参数是提升启动速度最有效的方法之一。

• 文件夹模式：pyinstaller -w your_script.py(默认就是文件夹模式)
• 单文件模式：pyinstaller -F -w your_script.py

对比分析：

• 启动速度：文件夹模式下的exe无需在临时目录解压大量文件，直接加载相邻的DLL和资源，启动速度通常比单文件模式快数倍。
• 文件体积：总体积两者相差不大（单文件略大，因为多了压缩封装的开销），但文件夹模式更直观，也便于用户查看日志、插件等。
• 用户体验：单文件exe更便于分发（一个文件）。文件夹模式需要压缩成ZIP发给用户，用户解压后运行其中的exe。对于普通用户，两者区别不大。
• 调试便利性：文件夹模式下，如果程序崩溃，你可以在dist/your_app目录下找到更完整的错误信息和日志，方便排查。

建议：在开发和测试阶段，始终使用文件夹模式打包，便于调试。最终发布时，根据用户群体和分发渠道决定。如果启动速度是首要考量，优先选择文件夹模式。

4. 实战操作：一步步打造精简的PyQt5应用

让我们通过一个具体的例子，将上述策略串联起来，完成一次完整的优化打包流程。假设我们有一个简单的文本编辑器应用notepad_qt.py。

4.1 步骤一：创建纯净的虚拟环境并安装依赖

# 1. 创建并激活虚拟环境 python -m venv venv_notepad # Windows venv_notepad\Scripts\activate # Linux/macOS source venv_notepad/bin/activate # 2. 升级pip python -m pip install --upgrade pip # 3. 安装核心依赖（使用国内镜像加速） pip install PyQt5 -i https://pypi.tuna.tsinghua.edu.cn/simple pip install pyinstaller -i https://pypi.tuna.tsinghua.edu.cn/simple # 我们的编辑器不需要其他额外库

4.2 步骤二：编写并优化主程序代码

notepad_qt.py示例（已做导入优化）：

import sys # 只导入最核心、一定会用到的模块 from PyQt5.QtWidgets import QApplication, QMainWindow, QTextEdit, QAction, QFileDialog, QMessageBox from PyQt5.QtGui import QIcon, QKeySequence from PyQt5.QtCore import Qt class Notepad(QMainWindow): def __init__(self): super().__init__() self.init_ui() self.current_file = None def init_ui(self): self.text_edit = QTextEdit() self.setCentralWidget(self.text_edit) self.create_menus() self.setGeometry(300, 300, 800, 600) self.setWindowTitle('精简记事本') def create_menus(self): menubar = self.menuBar() # 文件菜单 file_menu = menubar.addMenu('文件(&F)') # 使用惰性导入？对于菜单动作，通常会在初始化时绑定，所以顶部导入QAction是合理的。 # 但像“打印”这种可能用不到的功能，可以条件导入。 new_action = QAction('新建(&N)', self) new_action.setShortcut(QKeySequence.New) new_action.triggered.connect(self.new_file) file_menu.addAction(new_action) open_action = QAction('打开(&O)...', self) open_action.setShortcut(QKeySequence.Open) open_action.triggered.connect(self.open_file) file_menu.addAction(open_action) save_action = QAction('保存(&S)', self) save_action.setShortcut(QKeySequence.Save) save_action.triggered.connect(self.save_file) file_menu.addAction(save_action) save_as_action = QAction('另存为(&A)...', self) save_as_action.triggered.connect(self.save_file_as) file_menu.addAction(save_as_action) file_menu.addSeparator() exit_action = QAction('退出(&X)', self) exit_action.setShortcut(QKeySequence.Quit) exit_action.triggered.connect(self.close) file_menu.addAction(exit_action) # 帮助菜单 help_menu = menubar.addMenu('帮助(&H)') about_action = QAction('关于(&A)', self) about_action.triggered.connect(self.show_about) help_menu.addAction(about_action) def new_file(self): self.text_edit.clear() self.current_file = None self.setWindowTitle('精简记事本 - 未命名') def open_file(self): # 文件对话框在函数内导入（惰性导入示例） # from PyQt5.QtWidgets import QFileDialog # 已顶部导入，此处无需重复 file_name, _ = QFileDialog.getOpenFileName(self, "打开文件") if file_name: try: with open(file_name, 'r', encoding='utf-8') as f: self.text_edit.setText(f.read()) self.current_file = file_name self.setWindowTitle(f'精简记事本 - {file_name}') except Exception as e: QMessageBox.critical(self, "错误", f"无法打开文件:\n{e}") def save_file(self): if self.current_file: try: with open(self.current_file, 'w', encoding='utf-8') as f: f.write(self.text_edit.toPlainText()) except Exception as e: QMessageBox.critical(self, "错误", f"保存文件失败:\n{e}") else: self.save_file_as() def save_file_as(self): file_name, _ = QFileDialog.getSaveFileName(self, "另存为") if file_name: self.current_file = file_name self.save_file() self.setWindowTitle(f'精简记事本 - {file_name}') def show_about(self): # 关于对话框在函数内导入（惰性导入示例） # from PyQt5.QtWidgets import QMessageBox # 已顶部导入 QMessageBox.about(self, "关于精简记事本", "这是一个演示PyQt5打包优化的示例程序。") def main(): app = QApplication(sys.argv) app.setStyle('Fusion') # 使用Fusion风格，跨平台一致 notepad = Notepad() notepad.show() sys.exit(app.exec_()) if __name__ == '__main__': main()

4.3 步骤三：生成并编辑Spec文件进行精细控制

1. 生成初始spec文件：pyi-makespec -w notepad_qt.py。这会生成notepad_qt.spec。
2. 编辑notepad_qt.spec，应用我们的优化策略：

# -*- mode: python ; coding: utf-8 -*- block_cipher = None # 定义哪些模块绝对不需要 excluded_modules = [ 'PyQt5.QtWebEngine', 'PyQt5.QtWebEngineCore', 'PyQt5.QtWebEngineWidgets', 'PyQt5.QtMultimedia', 'PyQt5.QtMultimediaWidgets', 'PyQt5.QtBluetooth', 'PyQt5.QtNfc', 'PyQt5.QtSensors', 'PyQt5.QtSerialPort', 'PyQt5.QtSql', 'PyQt5.QtTest', 'PyQt5.QtXml', 'PyQt5.QtXmlPatterns', 'matplotlib', # 我们没用，如果有其他库也在此排除 ] a = Analysis(['notepad_qt.py'], pathex=[], binaries=[], datas=[], hiddenimports=[], # 我们的代码没有隐藏导入 hookspath=[], runtime_hooks=[], excludes=excluded_modules, # 应用排除列表 win_no_prefer_redirects=False, win_private_assemblies=False, cipher=None, noarchive=False) pyz = PYZ(a.pure, a.zipped_data, cipher=block_cipher) exe = EXE(pyz, a.scripts, a.binaries, a.zipfiles, a.datas, [], name='notepad_qt', debug=False, bootloader_ignore_signals=False, strip=False, upx=True, # 启用UPX压缩 runtime_tmpdir=None, console=False, # 由 -w 参数决定，这里是False icon=None) # 可以在此处指定图标路径，如 'icon.ico'

4.4 步骤四：使用优化后的Spec文件进行打包

假设UPX已安装在默认路径或已加入系统PATH。

pyinstaller notepad_qt.spec

打包完成后，在dist目录下会生成notepad_qt文件夹。

4.5 步骤五：手动清理与最终验证

1. 进入打包目录：cd dist/notepad_qt
2. 手动删除不必要的文件（此步骤需要谨慎，最好在备份后进行）：
   • 删除PyQt5/Qt/plugins下可能不需要的插件子目录，如audio,bearer,mediaservice,position,sensorgestures,webview等。我们的记事本基本用不到这些。
   • 删除PyQt5/Qt/translations下非目标语言的.qm文件（如只保留qt_zh_CN.qm如果支持中文）。
   • （可选但风险较高）检查根目录下的DLL，如果确信不需要，可以尝试移除如Qt5Network.dll,Qt5Qml.dll等。每删除一个，都要测试程序所有功能是否正常。
3. 测试功能：双击notepad_qt.exe，逐一测试新建、打开、保存、另存为、关于等所有功能，确保没有因删除文件而导致崩溃或功能缺失。
4. 体积对比：
   • 优化前（默认打包）：文件夹大小可能在120MB - 150MB左右。
   • 优化后（排除模块+手动清理）：文件夹大小有望缩减到40MB - 60MB，甚至更小。
   • 启动速度也会有明显感知的提升。

5. 进阶技巧与疑难问题排查

即使遵循了上述所有步骤，你可能还是会遇到一些奇怪的问题。这里分享一些进阶技巧和常见问题的排查方法。

5.1 处理运行时动态加载的模块或资源

有些库（包括PyQt5自身）会在运行时动态查找资源，例如通过pkgutil、importlib.resources或Qt的插件系统。Pyinstaller的静态分析可能无法发现这些依赖。

• Qt插件问题：如果你的程序使用了特定的图片格式（如WebP）或数据库驱动，需要对应的Qt插件。如果运行时提示找不到插件，你需要在spec文件的binaries或datas中手动添加。更简单的方法是，将必要的插件文件夹（如PyQt5/Qt/plugins/imageformats）整个添加到datas中。

  # 在spec文件的Analysis部分或后面添加 import os from PyQt5.QtCore import QLibraryInfo # 添加基本的Qt插件（平台插件和图像格式插件） qt_plugin_path = QLibraryInfo.location(QLibraryInfo.PluginsPath) a.datas += [(os.path.join(qt_plugin_path, 'platforms'), 'PyQt5/Qt/plugins/platforms', 'DATA')] a.datas += [(os.path.join(qt_plugin_path, 'imageformats'), 'PyQt5/Qt/plugins/imageformats', 'DATA')]

  注意：QLibraryInfo.location在打包后的环境中可能不可靠。更稳妥的做法是硬编码路径，或通过sys._MEIPASS来定位资源（在运行时临时目录）。

• 数据文件：如果你的代码通过相对路径或pkg_resources访问包内数据文件，需要将其添加到datas。

  # 假设你的项目有一个 data 文件夹，里面包含 config.json a.datas += [('data/config.json', 'data', 'DATA')]

5.2 使用--paths参数解决模块查找问题

如果你的项目有自定义的模块目录结构，Pyinstaller可能找不到它们。使用--paths参数可以指定额外的搜索路径。

pyinstaller --paths=./src --paths=./lib -w your_script.py

或者在spec文件中：

a = Analysis(['your_script.py'], pathex=['./src', './lib'], # 添加项目特定路径 ...)

5.3 常见错误与解决方案速查表

5.4 终极武器：换用Nuitka编译（可选）

如果对启动速度和文件体积有极致要求，并且不介意更复杂的配置过程，可以考虑使用Nuitka。Nuitka 是一个将Python代码编译成C语言，再编译成机器码的工具。它生成的二进制文件：

• 启动速度：接近原生C++程序的速度，远超Pyinstaller。
• 文件体积：可能更小，因为它可以只链接真正用到的库部分，并进行深度优化。
• 反编译难度：极大提高，因为代码被编译成了机器码。

但是，Nuitka的配置比Pyinstaller复杂得多，对PyQt5、NumPy等带有C扩展的库需要特殊处理，且编译时间很长。对于大多数项目，经过充分优化的Pyinstaller方案已经足够。只有当性能成为绝对瓶颈时，才建议考虑Nuitka。

优化打包是一个平衡的艺术，需要在体积、速度、兼容性和易用性之间找到最佳结合点。从创建一个干净的虚拟环境开始，有选择地应用排除模块、惰性导入、UPX压缩等策略，并善用spec文件进行精细控制，你完全可以将一个数百兆的“胖子”应用，成功瘦身为一个几十兆、启动迅速的“精神小伙”。这个过程虽然有些繁琐，但当你看到用户无需漫长等待就能流畅使用你的软件时，这一切努力都是值得的。