Qt 6.5 LTS源码编译失败：编译器无法找到QFile等类头文件

1. 强制使用独立构建目录 #

• 绝对不能在Qt源码目录内直接编译，必须创建独立的构建目录隔离编译过程：

  mkdir qt6-build && cd qt6-build
  ../qt-everywhere-src-6.5.0/configure -prefix /opt/qt6
  

• 若源码目录有残留编译文件，彻底清理：

  cd qt-everywhere-src-6.5.0
  git clean -dfx
  

2. 校验configure参数 #

• 不要手动添加-I/-L类参数覆盖Qt内部头文件路径，主机构建用默认参数即可，避免干扰Qt的路径解析逻辑。

3. 处理命名空间警告 #

• 针对does not include QT_BEGIN_NAMESPACE警告，是正式版调整了头文件规范导致的，手动修改对应头文件：
  在qcompressedhelpinfo.h开头插入：

  QT_BEGIN_NAMESPACE
  

  文件末尾添加：

  QT_END_NAMESPACE
  

• 大量同类警告时，直接删除构建目录后重新configure，避免缓存残留。

4. 补全系统依赖 #

• Ubuntu 22.10编译Qt 6.5需要完整依赖，执行以下命令安装：

  sudo apt install build-essential libgl1-mesa-dev libx11-dev libxkbcommon-dev libxkbcommon-x11-dev libwayland-dev libxcb-xinerama0-dev libxcb-xinput-dev libxcb-randr0-dev libxcb-shape0-dev libxcb-xfixes0-dev
  

5. 复用RC版本构建配置 #

• 若以上方法无效，可将RC版本构建目录下的.qmake.conf复制到正式版构建目录，替换后重新执行make。

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