QML Window中图片无法显示问题求助（附代码与配置）

出现QML Image: Cannot open: qrc:/imageResource/snow.jpeg错误，通常是资源配置或路径问题，按以下几点排查：

• 资源文件（.qrc）未正确配置
  确认你的.qrc文件中是否正确包含了图片路径，示例正确配置如下：

  <RCC>
      <qresource prefix="/">
          <file>imageResource/snow.jpeg</file>
      </qresource>
  </RCC>
  

  注意：prefix决定了资源的根路径，若prefix设为/imageResource，则访问路径应为qrc:/imageResource/snow.jpeg；若prefix为/，则路径需和<file>标签内的层级完全一致。

• CMakeLists.txt未引入资源文件
  必须在CMake配置中把.qrc文件添加到项目编译流程，否则资源不会被打包进程序。示例代码：

  # 创建资源目标
  qt_add_resources(APP_RESOURCES your_resources.qrc)
  # 将资源链接到可执行文件
  target_link_libraries(your_app_name PRIVATE Qt6::Quick ${APP_RESOURCES})
  

  旧版Qt可使用QT5_ADD_RESOURCES命令，确保资源被正确编译。

• 路径大小写不匹配
  在Linux/macOS等大小写敏感的系统中，文件名和路径的大小写必须完全一致。比如实际文件是Snow.jpeg，但.qrc中写的是snow.jpeg，就会导致加载失败。

• 实际目录层级与.qrc配置不符
  检查图片的实际存放位置：

  • 若.qrc文件在项目根目录，imageResource文件夹也在根目录，那<file>imageResource/snow.jpeg</file>是正确的；
  • 若imageResource在qml文件夹下，那.qrc中路径应为<file>qml/imageResource/snow.jpeg</file>，对应访问路径是qrc:/qml/imageResource/snow.jpeg。

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