使用QFile读取Qt项目内文件失败的原因及疑问

失败原因 #

• 路径前缀错误：:/ 是Qt资源文件（.qrc）的专属访问前缀，只有被添加到.qrc中的资源文件才能通过这个路径读取。你的newform.ui没加入资源文件，用":/newform.ui"作为路径时，QFile根本找不到目标文件。
• 运行时工作目录不匹配：就算改用相对路径（比如"./newform.ui"），也可能因为Qt Creator默认运行工作目录是项目构建目录而非源码目录，导致.ui文件不在程序运行时的查找范围内，加载失败。

是否必须使用Qt资源文件？ #

不是必须，但资源文件能彻底规避路径问题，是Qt项目加载本地资源的推荐方案。如果不想用资源文件，可按以下两种方式处理：

方式1：修正路径并同步文件到运行目录 #

1. 绝对路径（不推荐）：直接写死文件的绝对路径，换环境后会失效，示例代码：

QFile file("D:/YourProjectDir/newform.ui");

2. 相对路径+构建同步：在项目的.pro文件中添加配置，将.ui文件复制到构建目录，确保程序运行时能找到：

   # 将newform.ui复制到构建输出目录
   resources.files = newform.ui
   resources.path = $$OUT_PWD
   INSTALLS += resources
   

   之后用相对路径加载：

   QFile file("./newform.ui");
   

方式2：使用资源文件（推荐） #

1. 在Qt Creator右键项目 → 添加新文件 → Qt → Qt资源文件，创建一个.qrc文件（比如res.qrc）。
2. 打开.qrc文件，点击「添加」→「添加文件」，选中newform.ui。
3. 之后就能用":/newform.ui"的路径正常加载文件了。

QUiLoader加载补充 #

后续用QUiLoader加载时，路径逻辑和QFile一致：

• 用资源文件的话，直接传资源路径：

  QUiLoader loader;
  QFile file(":/newform.ui");
  if (file.open(QFile::ReadOnly)) {
      QWidget *form = loader.load(&file, this);
      // 后续操作逻辑
  }
  

• 不用资源文件的话，确保路径正确且文件在运行目录即可。

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