PyQt5打包exe图片QSS丢失？用qrc内嵌资源彻底解决

开头想先问一句你写过PyQt5的GUI程序做得顺顺利利的运行也没问题但用PyInstaller打包成exe发给别人对方双击打开的瞬间直接闪退或者图片、样式全都没了界面丑得没法看如果有恭喜你踩中了打包资源文件这个经典大坑。这篇文章不聊虚的直接围绕“用PyInstaller打包PyQt5的GUI程序且必须包含图片资源和QSS文件”这件事把原理、步骤、坑位、绕坑技巧一次讲完。适合刚学会PyQt5但还没折腾过打包的开发者也给那些已经打包成功但每次换资源都要重新折腾一遍的人一个更好的方案。1. 打包前先搞明白资源和路径本来就和你想的不一样1.1 PyInstaller打包的本质PyInstaller做的事情说白了就是把Python解释器、你用到的第三方库、你的代码逻辑以及程序运行所需要的一切依赖全部塞进来然后打包成一个自解压的可执行文件。它里面的机制很有意思当你从命令行运行python YourApp.py时Python是按你电脑上的目录结构去找模块和资源的而打包后程序运行时会把所有内容解压到一个系统临时目录里这个目录每次运行可能都不一样甚至同一个程序在不同电脑上运行时这个临时目录路径也完全不同。这个路径变化就是打包后程序找不到图片和QSS文件的根源所在。举个例子你在开发时写的是logo.png就在当前目录代码里简单一句QPixmap(logo.png)就能加载。打包后程序却是在临时目录里运行的默认的当前工作目录是临时目录你的logo.png如果在打包时没有被放进临时目录那这句代码自然加载不到任何内容表现出来的结果就是图片空白或者程序因为找不到资源直接报错崩溃。1.2 为什么要单独处理图片资源和QSS文件PyQt5程序往往会用到三类资源窗口图标和按钮图片、QSS样式表用来美化界面的样式文件、以及项目里引用到的其他静态文件。这三个东西PyInstaller默认是不认识它们的。PyInstaller只分析Python代码里import到的模块它不知道你的代码里还通过字符串路径加载了一个pixmap文件。如果你不做任何处理PyInstaller打包出来的exe文件根本不会把图片和QSS带进去。很多人第一次打包时三个文件都在同目录下自己本地运行exe好像没问题是因为工作目录刚好没变。但换到别人电脑上或者从快捷方式启动工作目录一变就原形毕露。这个现象给我的教训就是打包PyQt5程序资源文件必须显式告诉PyInstaller否则等于没带。1.3 核心解决思路内嵌资源还是外带文件目前处理这部分问题的方案主要分两条线方案A通过--add-data参数把图片和QSS文件作为外部资源随exe一起分发运行时通过路径检测切换开发/打包环境。方案B用PyQt5自带的pyrcc5工具把图片和QSS先编译成Python模块然后直接import进来使资源彻底内嵌进exe里。这两个方案在场景上各有优势。方案A适合图片多、体积大、需要经常替换资源的项目比如做一个图片查看器用户未来可能要往文件夹里丢新图片方案B适合把一切资源做成单文件交付发一个exe过去就完事非常适合工具类小程序和公司内部使用的小软件。我自己平时90%的项目都用方案B省事且不容易出路径问题但方案A在一些特殊场景下确实更好下面分开讲。2. 环境准备打包前你最好先做好这几件事2.1 Python版本与虚拟环境打包最忌讳的是在一个装满了各种包的环境里直接动手不然PyInstaller会把所有import过的东西都扫描进依赖图最后打出来的exe体积大是小事更麻烦的是可能因为依赖冲突而启动失败。我通常会为每个GUI项目单独建一个虚拟环境只装项目必须的库。python -m venv venv如果是Windows环境激活方式venv\Scripts\activate然后在虚拟环境内安装依赖pip install pyqt5 pyinstallerPyQt5的包名要注意PyQt5这个包本身就包含了Qt核心库和常用模块安装这个就够用了。不建议在系统Python里装一堆来源混杂的包后直接打包你在那台机器上能跑起来和你把exe拿到别的机器上能跑起来完全不是一回事。2.2 版本兼容问题PyInstaller对Python版本和PyQt5版本有明确的兼容范围。比如Python 3.12刚出来时PyInstaller更新滞后直接用它打包会报各种不可名状的错误。我踩过一次坑明明代码没问题打包也报了成功但运行时就提示缺少某个内部模块。最后发现是Python版本太新PyInstaller还没适配完。如果你不是有特殊要求建议使用Python 3.8到3.11之间的稳定版本搭配PyQt5 5.15系列这是目前踩坑最少、社区讨论最多的组合。PyQt6在打包时的资源处理逻辑与PyQt5基本一致但如果你用的是PyQt6打包命令和API会有少许变化本文以PyQt5为核心。提示装完PyQt5后顺手验证一下安装是否正常。在Python里执行from PyQt5.QtWidgets import QApplication不报错就说明环境OK。别等到打包完才发现PyQt5本身没装好这种低级错误最耗时间。2.3 准备一个最简测试用例正式打包前建议准备一个最小可运行的PyQt5窗口程序只包含一个窗口、一张背景图片和一个QSS文件。先用这个小项目验证打包流程对不对再切换到真实项目。原因是真实项目往往很大如果打包出问题很难定位到底是资源问题还是代码问题最小用例能让你把资源处理的逻辑独立验证一遍确认方案本身没有缺陷。这个习惯帮我节省了大量排查时间。3. 方案A用--add-data外部携带资源文件3.1 添加资源文件的基本命令PyInstaller的--add-data参数用于把任意文件或目录一起打包。基本格式是源路径和目标路径之间用分隔符隔开。Windows下分隔符是分号;Linux和macOS下是冒号:。这是很多人忽略却致命的一点在Windows上习惯了冒号写法结果打包出来exe运行时找不到文件排查半天才发现是分隔符的问题。以Windows为例如果你的项目结构是这样project/ main.py assets/ logo.png style.qss那打包命令可以这么写pyinstaller --onefile --windowed --add-data assets;assets main.py命令的含义是把本地assets目录里的所有内容拷贝到打包后运行时临时目录下的assets目录里。--windowed表示不显示命令行黑框GUI程序一般都要加这个参数。3.2 代码里如何正确找到资源文件路径开发时assets目录就在项目根目录下代码里写assets/logo.png没问题。打包后资源被释放到临时目录这个临时目录在PyInstaller的机制下路径会存到一个特殊变量里。PyQt5程序里推荐写法是import sys import os def resource_path(relative_path): 获取资源的绝对路径兼容开发环境和PyInstaller打包环境 base_path getattr(sys, _MEIPASS, os.path.abspath(.)) return os.path.join(base_path, relative_path)这段代码的原理很简单sys._MEIPASS是PyInstaller在打包后运行时设置的属性指向解压临时目录如果你在开发环境运行时它不存在就退回当前工作目录。用这个函数来改写你的资源加载代码from PyQt5.QtGui import QPixmap pixmap QPixmap(resource_path(assets/logo.png))加载QSS文件同理with open(resource_path(assets/style.qss), encodingutf-8) as f: app.setStyleSheet(f.read())3.3 方案A的坑与适用场景方案A最直观但坑也藏得很深。第一个坑是上面讲的打包后运行环境与开发环境路径不同如果你没用sys._MEIPASS做路径适配即使--add-data配置正确程序依然可能找不到文件。第二个坑是如果你用了--onefile模式exe文件运行时会把资源解压到临时目录然后在程序结束时清理掉。如果程序启动慢一部分原因就是这个解压动作。而如果放在程序里的某张图片路径写的是相对路径程序运行时的工作目录不是exe所在目录那一样会出错。建议exe的启动方式尽量改成从快捷方式启动或者把工作目录固定住。第三个坑是资源文件的更新。方案A下logo.png是作为外部文件存在的你可以通过替换exe旁边的资源文件来更新图片风格而不必重新打包exe这是它的灵活之处。但代价是发给别人时要成对发送exe和assets目录少一个都不行。如果你交付的对象是非技术同事对方搞丢其中一个文件夹的概率非常高。方案A适合资源体积大、经常需要单独更换资源、程序本身以--onedir模式打包的项目。比如你做一个素材管理工具素材库有上万个文件那肯定不能塞进exe勤奋用外部目录的思路是对的。4. 方案B用qrc把图片和QSS编译进py文件重点推荐4.1 为什么我强烈推荐这个方案方案B的核心思路是用Qt的qrc资源系统把图片和QSS文件统一登记到一个qrc清单里再用pyrcc5把它编译成一个Python文件之后在代码里直接import它。因为导入的Python文件会被PyInstaller当作普通模块分析到并一起打包进exe所以图片和QSS的内容实际上已经以字节形式存在于Python模块内部了。你在程序里通过Qt资源路径:/前缀访问它们时根本不涉及磁盘上的文件路径自然不存在“找不到文件”的问题。这解决了方案A里所有路径适配的烦恼也让exe可以真正做到单文件分发。发给谁都能双击跑不会因为少带某个资源文件而白屏。代价是第一次配置流程多两步但流程是固定的熟练后三分钟搞定。4.2 编写qrc资源清单文件在项目目录下新建一个res.qrc文件内容是一个简单的XML结构RCC qresource prefix/ fileassets/logo.png/file fileassets/style.qss/file /qresource /RCC这里的file标签填写的是相对路径指向qrc文件所在目录下的资源文件。prefix表示资源在Qt资源系统中的虚拟路径前缀保持/即可。之后代码里访问logo.png时用的路径就是:/assets/logo.png。小技巧如果你的项目用了Qt Designer画界面可以在Designer界面编辑器中直接添加资源文件它会自动维护qrc文件右键qrc文件就能看到“添加现有文件”很方便。但即使手写这个XML也不难就几个标签。4.3 用pyrcc5编译资源PyQt5安装完成后会在Python所在目录的Scripts文件夹下生成pyrcc5.exeWindows或同名命令Linux/macOS。在命令行中执行pyrcc5 -o res_rc.py res.qrc这里生成的res_rc.py就是编译后的资源模块。不要直接查看里面的内容它是二进制数据打包成的Python源码正常情况下是不可读的。你要做的是在main.py里加一行import res_rc注意编译生成的模块名默认是res_rc如果你的qrc文件名是res.qrc那生成的默认模块名就是res_rc.py。也可以自己指定输出文件名但记得导入时必须一致。之后代码里通过:/assets/logo.png访问图片pixmap QPixmap(:/assets/logo.png) icon QIcon(:/assets/logo.png)QSS文件的加载要稍微变一下因为Python的内建open()函数是不认识Qt资源路径的。此时要用Qt的QFile类from PyQt5.QtCore import QFile def load_stylesheet(qss_path): file QFile(qss_path) file.open(QFile.ReadOnly | QFile.Text) stylesheet str(file.readAll(), encodingutf-8) file.close() return stylesheet app.setStyleSheet(load_stylesheet(:/assets/style.qss))注意如果你在代码里还调用了win.setWindowIcon(QIcon(:/assets/logo.png))那么只要import了res_rc窗口图标在任何环境下都会正常显示因为图片资源已经完完整整写在模块里了。这比从磁盘判断路径要可靠得多。这里顺便提一个容易踩的坑qrc文件中的编码格式。如果QSS文件里含有中文注释或者中文编码的特殊字符建议统一使用UTF-8编码保存qrc和QSS文件避免编译后出现解码异常。4.4 方案B的实际效果与体积变化方案B把PNG、JPG这些图片以字节形式内嵌进py文件会导致exe体积增加。如果图片比较大比如P图软件制作的多张高清背景图片动辄百兆级别那方案B就不合适了。正常情况下几张按钮图标、logo、背景图加一个QSS一共也就几兆对exe体积影响不大。我曾把一个带7张图片和一个QSS的小工具打包用方案B打出来的exe比方案A大2MB左右但运行时稳定程度提升明显发给几个部门同事用没人再反馈“图片没了”之类的问题。从维护角度看如果后续想换logo、换主题色只需修改素材文件然后重新执行pyrcc5和PyInstaller打包流程是固定的风险极低。我日常项目基本都用这个方案。5. 打包命令与spec文件的精细配置5.1 一条最简单的打包命令完成代码和资源模块的准备后打包命令就比较简单了。在虚拟环境里执行pyinstaller --onefile --windowed main.pyPyInstaller会分析main.py里import的全部模块包括res_rc因为res_rc是Python文件它的内部数据会被完整打入exe。不需要再加上任何add-data参数了。这一步会生成一个exe文件位于dist目录下双击运行即可看到带图片、带样式的窗口程序。如果你连窗口图标都想自定义成自己设计的ico文件可以加一条--icon参数pyinstaller --onefile --windowed --iconapp.ico main.py注意这里的--icon指定的是exe文件本身的显示图标和window.setWindowIcon里设置的窗口图标是完全两个概念别混淆。5.2 spec文件更精细的打包配置PyInstaller每次打包后会在项目目录生成一个main.spec文件。这个文件是打包过程的完整蓝图有必要看懂它。尤其是资源文件较多、依赖较复杂时直接修改spec文件再执行打包比在命令行里写一长串参数更可控。一个简化后的spec文件长这样# -*- mode: python ; coding: utf-8 -*- a Analysis( [main.py], pathex[], binaries[], datas[], hiddenimports[], hookspath[], runtime_hooks[], excludes[], noarchiveFalse, ) pyz PYZ(a.pure) exe EXE( pyz, a.scripts, a.binaries, a.zipfiles, a.datas, [], namemain, debugFalse, bootloader_ignore_signalsFalse, stripFalse, upxFalse, consoleFalse, iconapp.ico, )逐个说一下关键字段datas对应命令行里的--add-data格式是元组列表[(assets, assets)]表示把assets目录拷入assets。如果你走的方案B这里保持空列表就行。hiddenimportsPyInstaller静态分析无法发现但运行时又需要的模块写在这里。比如一些通过字符串动态导入的模块。consoleFalse表示不显示控制台窗口True则显示调试时很有用。excludes要排除的模块列表可以显著减小exe体积。upx是否启用UPX压缩。实测下来UPX在很多场景下会导致exe运行异常不建议开。用spec文件方式打包pyinstaller main.spec这个命令会直接按照spec配置执行不再重新生成spec文件。当你下一次只想改个图标、改个打包名字直接编辑spec后重新执行就行。5.3 --onefile和--onedir怎么选PyInstaller提供两种打包风格。--onefile把所有内容打包成一个exe--onedir会生成一个目录里面是exe和一堆依赖库文件。很多人追求单文件觉得发给别人方便但它有两个代价第一启动会慢一点因为每次运行都要把全部依赖解压到临时目录第二杀毒软件误报率比onedir模式更高因为单文件exe的自解压特征在某些安全软件看来比较可疑。如果你交付给公司内部IT团队建议用onedir模式配合目录内部的exe启动稳定性和启动速度都更好。如果是个人小程序分享给别人onefile更方便。从Windows平台实战看onedir模式下系统目录里会多出一堆dll文件如果用户手动删掉某个dll程序还是会挂。所以千万别把onedir当成免维护方案。6. 完整实战演示一个小例子走完全流程为了方便直接照抄我在这里用一个模拟项目X来演示整个完整流程。项目假设叫“素材工具箱”界面是一个主窗口包括顶部的logo和一张背景样式全部由QSS控制。6.1 项目结构material_tool/ main.py res.qrc assets/ logo.png style.qss6.2 main.py完整示例import sys from PyQt5.QtWidgets import QApplication, QMainWindow, QLabel from PyQt5.QtCore import QFile from PyQt5.QtGui import QPixmap import res_rc # 关键引入编译后的资源模块 def load_stylesheet(qss_path): file QFile(qss_path) file.open(QFile.ReadOnly | QFile.Text) stylesheet str(file.readAll(), encodingutf-8) file.close() return stylesheet class MainWindow(QMainWindow): def __init__(self): super().__init__() self.setWindowTitle(素材工具箱) self.setWindowIcon(QPixmap(:/assets/logo.png)) label QLabel(self) label.setPixmap(QPixmap(:/assets/logo.png)) label.setGeometry(100, 100, 200, 200) def main(): app QApplication(sys.argv) app.setStyleSheet(load_stylesheet(:/assets/style.qss)) window MainWindow() window.show() sys.exit(app.exec_()) if __name__ __main__: main()这段代码里所有图片访问都走了Qt资源系统路径:/assets/xxx完全不依赖当前工作目录。要注意的是import res_rc这段必须在你使用图片资源前执行Python的import在模块顶部做了就万事大吉。6.3 执行流程先编译资源pyrcc5 -o res_rc.py res.qrc然后打包pyinstaller --onefile --windowed main.py如果一切正常dist目录下会生成一个main.exe。双击运行应该能看到右上角logo和继承QSS背景色的窗口界面。整个流程熟练后变成肌肉记忆就三个命令pyrcc5编译pyinstaller打包运行测试。7. 常见问题与排查技巧实录7.1 打包后exe运行闪退闪退是打包后最常见的问题。排查思路按顺序走如果打包时没用--windowed改成带控制台模式重新打包pyinstaller --onefile main.py这样运行时能把报错信息打印在控制台上。GUI程序闪退时错误信息往往是定位的唯一抓手。看报错是ModuleNotFoundError还是FileNotFoundError。ModuleNotFoundError通常是PyInstaller漏了某个模块去spec文件里的hiddenimports字段补上即可。FileNotFoundError则几乎可以确定是资源路径问题检查你代码里是否所有资源访问用了正确的方案。如果你打的是onedir模式的包在dist目录的命令行下直接运行exe观察报错信息如果是onefile模式可以先切到onedir模式定位因为onefile模式下报错信息一闪而过很难截取。7.2 打包后图片丢失或QSS完全不起作用排除代码写法问题后先确认两件事编译生成的res_rc.py是否成功import进去了是否在程序任何位置用open()函数去读:/开头的路径。open()不支持Qt资源协议必须用QFile。曾经有位同事的代码里混用了两种模式一半用QPixmap(:/...)通了另一半用open读QSS就报错搞了很久才发现是写法混了。7.3 exe文件体积异常巨大PyQt5本身有几十MB的库文件打包出来在30MB到80MB之间都是正常的。如果异常大排查有没有把不必要的模块打包进去。比如你项目里使用了requests但在GUI逻辑里不是核心功能可以用spec文件的excludes字段排除一些用不到的模块比如excludes[tkinter, matplotlib, numpy]同时检查datas里是否误加了大目录。不要为了“以防万一”把整个venv目录加进去那是体积爆炸的经典原因。7.4 打包后启动速度慢、卡在加载中如果用的是onefile模式启动慢是正常现象因为要解压。如果你用了很多图片且都放在资源系统里图片解码也需要时间。优化手段很有限最有效的是放弃onefile改用onedir。反正启动慢不会超过几秒工具类小软件用户通常能接受。7.5 新版Windows提示未知发布者这是Windows的SmartScreen机制导致的提示因为你的exe没有代码签名。解决思路只有两个买商业代码签名证书正式签名或者接受这个提示。公司内部使用的话可以直接把exe所在目录加入杀毒软件信任区或者给团队成员一次性的“仍要运行”提醒。7.6 PyInstaller打包后模块缺失这种情况多出现在使用了动态import的代码里比如__import__函数导入的模块或运行时生成的插件模块。PyInstaller的静态分析器看不到它们。在spec文件的hiddenimports字段里显式列出这些模块名重新打包即可。7.7 常见问题速查表现象可能原因建议操作运行闪退无提示模块缺失/资源路径错误用控制台模式打包看报错图片空白未正确处理资源路径改走qrc资源系统或加路径适配QSS不生效用open读取资源协议路径改为QFile读取启动慢onefile解压耗时改用onedir模式exe太大打包进无关模块/资源清理excludes与datas模块找不到动态导入未被分析在hiddenimports显式添加杀毒误报单文件自解压特征加代码签名或转onedir8. 关于QSS文件与图片资源的进阶处理技巧8.1 字体与图片路径的联动坑QSS文件里经常会引用图片做背景比如QPushButton { border-image: url(:/assets/btn_bg.png); }如果走了qrc方案这里面的url路径必须和qrc文件中登记的资源路径一致。如果走add-data方案这里面的路径要写成”相对当前工作目录“的路径而且运行时工作目录可能不是你预期的目录这种情况下QSS里的图片最容易踩坑。所以只要QSS里引用背景图我个人都建议用qrc方案省得调试路经试半天。8.2 QSS里不要用中文字体名在Windows上写QSS时会写QWidget { font-family: 微软雅黑; }这在开发机上没问题但打包后到目标机器上如果那台机器没装微软雅黑字体字体渲染会变得很难看。建议用常见无衬线字体或者把字体文件也作为资源文件打包但后者的复杂度比较高。工具类软件内部使用的话直接写“Microsoft YaHei”和“SimHei”等英文名称稳定性更高。8.3 Qt Designer里维护qrc更省心如果你平时用Qt Designer设计界面可以在Designer的“资源浏览器”里维护qrc文件添加图片和QSS都很方便。Designer自动维护的qrc格式往往比手写的更规范不容易出现路径写错的问题。唯一的坑是Designer维护qrc时自动把图片资源路径转换为:/newPrefix/xxx.png这种形式要在qrc文件里确认prefix和路径符合你的预期。9. 打包过程中的注意事项与避坑经验9.1 打包前务必先清理缓存PyInstaller执行时会生成build目录和dist目录。build目录里存的是中间文件不删掉不会影响最终结果但如果前一次打包的配置有问题建议先把build目录删掉避免缓存影响到下次打包。9.2 用虚拟环境保证干净依赖虚拟环境的好处前面提过再强调一点如果你用系统环境打包PyInstaller会把系统环境中所有模块都扫描一遍哪怕你没用的模块也可能被分析器误判。用虚拟环境打包输出体积更可控打包失败的几率也更低。9.3 Windows上建议在Windows上打包PyInstaller不支持交叉编译你在Linux上打的包不能直接在Windows上运行。给同事分发Windows版exe就得在Windows机器或Windows虚拟机上操作打包。这个提醒看着多余实际工作中经常有人问为什么Linux打包出的东西Windows不能用。9.4 测试环境至少要有两台不同的机器自己机器上打包后能跑不代表别人机器上也能跑。最稳的做法是打包完exe后复制到一个相对干净的Windows环境里测试一下——所谓干净至少是没有安装Python、没有安装PyQt5。如果这个环境下程序能正常运行说明依赖都进去了如果在干净环境里报错“找不到Qt5Core.dll”或其他模块错误说明PyInstaller分析遗漏了某些依赖需要继续排查。我自己有一个固定习惯每次打包完成后立刻拷到一台装了纯净版Windows的虚拟机上双击测试。这个动作五秒钟就够但能拦截八成以上的隐藏问题。9.5 杀毒软件误报问题PyInstaller打包的exe被误报的情况在国产杀软和Windows Defender里都比较常见。退一步说这问题除了购买代码签名证书以外没有完美解法。国内个人开发者基本不会为工具类小软件买证书那就只能在交付时口头提醒对方添加信任。如果对方公司电脑安全策略特别严格onedir模式相对不容易触发误报可以作为备选方案。10. 扩展场景如果项目不止一个主程序或者涉及多个资源目录10.1 多主程序入口有些工具集项目会拆成几个可执行程序比如一个负责采集数据一个负责分析展示。PyInstaller支持在一个spec里配置多个Analysis目标但这种情况更常见的做法是分别打包。每个程序各建一个spec文件共用同一个资源模块互不干扰。如果你发现两个程序都要用同一套图片资源把res_rc.py放在共享目录里两边main.py都import它简单且省事。10.2 动态加载资源目录有些程序允许用户选择自定义主题包会在运行时读取某个目录下的图片和QSS文件。这种场景即便走qrc方案也不可能把online内容全部打进exe所以资源目录的读取逻辑要额外做一层设计默认资源走内嵌自定义资源走外部目录。加载代码要写成两级查找的逻辑外部有就加载外部外部没有就退回内嵌资源。这种案例和纯GUI小工具情况不同但核心思路是一样的资源来源明确区分防止路径混乱。10.3 给软件做多语言切换PyQt5自带翻译机制支持tr()和.qm文件。如果项目需要打包语言包做法和图片资源完全一致可以把qm文件放进qrc做内嵌也可以用add-data携带外部语言包。前者更适合一键单文件交付后者让翻译人员直接改外部文件即可不用重新打包。实际项目中我一般建议走add-data除非你铁了心发布的就是单文件安装包。11. 个人经验我踩过最深的坑和最终习惯最后分享一个实际开发中的体会。做PyQt5打包这几年我发现最多人包括我自己反复栽的坑并不是资源文件本身有多难处理而是开发时完全没考虑打包环境等到交付才一顿猛操作。平时写代码的时候凡是涉及到资源路径的地方都尽量走qrc的思路哪怕开发时觉得写成assets/logo.png直接就能出效果更省事。长期来看这个习惯能避免大量返工。另外我现在的固定工作流是这样新项目一开始就建立qrc文件把图片和QSS全部拖进去pyrcc5编译然后代码里全部用:/路径。打包时只敲pyinstaller --onefile --windowed main.py输出稳定交付前跑一遍虚拟机测试基本不会遇到需要半夜加班修打包问题的情况。如果这篇文章中间的坑你也遇到过或者你现在手头正在打包一个带图片资源的PyQt5程序卡壳了按着方案B走一遍应该能省下不少时间。最后再分享一个小技巧打包之前不用急着加--windowed先打成带控制台的版本跑通再切到无控制台模式重新打包这样出问题时能看到异常堆栈定位效率会高很多。