PyQt中loadUi()加载.ui文件后图片无法显示的解决求助

我之前也碰到过一模一样的情况——Qt Designer预览正常，但用loadUi加载后图片就失踪了，结合你的配置，这几个排查和解决步骤应该能帮到你：

• 务必在主程序中导入生成的资源文件
  你已经用pyrcc5把xz.qrc转成了xz_rc.py，但关键是要在加载UI之前导入这个文件。比如在主脚本的开头加上：

  import xz_rc
  

  如果xz_rc.py和你的主脚本不在同一目录，要么把它移到主脚本所在文件夹，要么确保它在Python的模块搜索路径里，或者用相对导入（比如from . import xz_rc，如果是包结构的话）。

• 检查UI文件中的图片路径格式
  打开new.ui文件，找到图片控件的source属性，确认它是qrc资源路径格式——比如:/images/your_image.png或者qrc:/images/your_image.png，而不是本地的绝对路径或相对路径。Qt Designer预览时会兼容本地路径，但PyQt加载UI时必须识别qrc定义的资源路径。

• 重新生成资源文件，确保没有错误
  有时候pyrcc5生成文件时可能因为路径或权限问题出问题，建议重新执行生成命令：

  pyrcc5 xz.qrc -o xz_rc.py
  

  执行完后打开xz_rc.py看看，里面应该有一大段生成的二进制资源代码，如果是空的，说明生成过程出错了，检查qrc文件的格式和图片路径是否正确。

• 确认loadUi的加载顺序
  导入资源文件的操作一定要在调用uic.loadUi()之前，比如正确的代码结构应该是这样：

  from PyQt5 import uic
  from PyQt5.QtWidgets import QMainWindow, QApplication
  import xz_rc  # 这行必须在loadUi之前！
  
  class MainWindow(QMainWindow):
      def __init__(self):
          super().__init__()
          uic.loadUi("new.ui", self)
  
  if __name__ == "__main__":
      app = QApplication([])
      window = MainWindow()
      window.show()
      app.exec_()
  

  资源文件需要先被PyQt加载到内存，这样loadUi解析UI文件时才能找到对应的图片资源。

• 排查资源文件的结构和路径
  打开xz.qrc文件，确认里面的配置和实际文件位置匹配。比如qrc的结构应该类似：

  <RCC>
      <qresource prefix="/">
          <file>images/background.png</file>
      </qresource>
  </RCC>
  

  这里的images/background.png是相对于xz.qrc文件的路径，要确保这个图片文件确实存在，而且文件名、路径没有拼写错误（大小写也要注意，Linux/macOS下是区分大小写的）。

如果以上步骤都试过还是不行，可以试试把资源文件改名——比如把xz.qrc改成app_resources.qrc，重新生成app_resources_rc.py后导入，有时候同名文件会导致导入冲突。

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