Ubuntu下Qt Creator开发QML项目：修复qrc:/main.qml不存在错误

针对你遇到的qrc:/main.qml: No such file or directory报错，按以下步骤排查解决：

• 检查资源文件(.qrc)配置
  确保main.qml以及需要加载的图片等资源都已添加到项目的.qrc文件中：

  1. 在Qt Creator的项目面板找到.qrc文件（通常命名为resources.qrc），双击打开资源编辑器
  2. 点击添加->添加现有文件，选中main.qml和相关资源文件
  3. 确认资源在qrc中的路径：如果代码里写的是qrc:/main.qml，那么main.qml必须直接放在qrc的根目录下（不是子文件夹里），路径拼写要完全匹配（Linux区分大小写）

• 验证项目构建文件配置
  根据你使用的构建系统，确保.qrc文件已被正确纳入构建：

  • 如果是qmake项目（.pro文件）：检查是否有RESOURCES += resources.qrc这一行，没有的话添加进去
  • 如果是CMake项目：确保CMakeLists.txt里有类似以下代码：

    qt_add_resources(YourProjectName_RESOURCES resources.qrc)
    target_sources(YourProjectName PRIVATE ${YourProjectName_RESOURCES})
    

• 避免路径混用问题
  如果你用qrc路径加载资源，所有资源都要通过qrc:/前缀访问，比如图片要写成qrc:/images/background.png，不要混用本地相对路径（.//../）。如果想使用本地路径，需要修改engine.load的路径为本地路径，同时在Qt Creator的项目->运行选项卡中，确认工作目录设置正确（通常设为项目根目录）。

• 清理重建项目
  Linux环境下Qt缓存可能导致资源未更新：

  1. 点击Qt Creator顶部菜单构建->清理项目
  2. 再点击构建->构建项目
  3. 重新运行程序

• 检查路径拼写大小写
  Linux系统严格区分大小写，确保代码中的qrc:/main.qml和qrc文件中实际的文件名大小写完全一致（比如不要把Main.qml写成main.qml）

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