编译Qt 6.2.1时提示“qplatformdefs.h”: No such file or directory错误

qplatformdefs.h是Qt针对当前编译环境生成的平台适配头文件，缺失该文件说明configure阶段的平台配置逻辑存在异常，或是构建路径配置存在错误。可按照以下步骤排查修复：

• 清空原有缓存，重建配置流程
  不要直接在Qt源码根目录执行configure操作，源码目录被生成文件污染会导致平台头文件生成异常，操作步骤如下：
  1. 删除所有历史生成文件：源码根目录下的CMakeCache.txt、CMakeFiles文件夹，以及指定安装目录E:\qt-stuff\6.2.1-build下的所有残留内容
  2. 新建独立的构建目录，例如E:\qt-stuff\6.2.1-build-temp，在VS 2019的x86 Native Tools Command Prompt中切换到该构建目录后，再执行configure命令，参数调整如下：

  E:\qt-stuff\qt-everywhere-src-6.2.1\configure.bat -debug-and-release -opensource -confirm-license -platform win32-msvc -nomake examples -nomake tests -prefix E:\qt-stuff\6.2.1-build
  

  调整说明：原参数中的win32-msvc2019标识在Qt 6中已合并为通用的win32-msvc，会自动适配当前加载的MSVC版本，错误的platform参数是导致平台头文件生成失败的常见原因；同时去掉了prefix路径末尾的多余反斜杠，避免批处理转义异常
• 验证配置结果
  configure执行完成后，先检查E:\qt-stuff\qt-everywhere-src-6.2.1\qtbase\mkspecs\win32-msvc目录下是否已生成qplatformdefs.h文件，确认存在后再执行构建操作。
• 调整编译并行数
  若确认配置无误仍编译报错，可先尝试单线程构建规避并行编译导致的依赖顺序问题：

  cmake --build . --parallel 1
  

  待基础模块编译完成后，再切换为多线程编译提升速度。

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