Qt项目如何实现增量构建而非全量重建？QMake全量重建问题

排查触发全量重建的核心原因 #

• 制止不必要的qmake自动运行：Qt Creator默认会在部分文件变更后自动执行qmake，比如修改.pro/.pri或环境变量变动。可在工具->选项->构建和运行->构建步骤中，取消qmake步骤的「构建前自动运行qmake」选项，仅在手动修改项目配置后手动触发qmake。
• 修正头文件依赖追踪：若.pro的HEADERS列表遗漏了被引用的头文件，QMake无法正确追踪依赖，修改这类头文件会导致大量源文件重建。确保所有被源文件引用的头文件都加入HEADERS，避免仅通过INCLUDEPATH引入未声明的头文件。
• 移除强制清理的自定义步骤：如果项目添加了预构建/后构建步骤（比如删除整个输出目录），会直接触发全量重建。将这类命令改为仅清理特定文件，或仅在手动执行「清理」操作时运行。

优化QMake配置提升增量构建效率 #

• 启用预编译头（PCH）：通过预编译公共头文件减少重复编译耗时，即使触发部分重建也能大幅提速。在.pro中添加：

  PRECOMPILED_HEADER = pch.h
  PRECOMPILED_SOURCE = pch.cpp
  

  需将所有公共依赖头文件放入pch.h，pch.cpp仅包含pch.h。
• 分离中间文件目录：将编译生成的目标文件、MOC/RCC/UI生成文件放到独立目录，帮助QMake更精准追踪文件修改时间：

  OBJECTS_DIR = build/obj
  MOC_DIR = build/moc
  RCC_DIR = build/rcc
  UI_DIR = build/ui
  

• 禁用全局重建触发器：避免在.pro中使用CONFIG += clean这类强制清理的配置，也不要在QMAKE_POST_LINK中写入删除目标文件的命令。

Qt Creator操作层面的调整 #

• 使用「构建」而非「重新构建」：修改代码后点击工具栏的「构建」（锤子图标），而非「重新构建」（锤子加箭头），后者会强制清理所有中间文件后全量编译。
• 切换至Ninja构建后端：Ninja相比默认Make的增量构建效率更高，可在项目->构建和运行->构建步骤->Make中，将构建工具切换为Ninja（需提前安装Ninja）。
• 检查文件监视功能：在工具->选项->环境->文件系统中确认文件监视正常工作，避免因无法检测文件变更而误触发全量重建。

额外注意事项 #

• 不要手动修改自动生成文件：ui_*.h、moc_*.cpp等自动生成文件被手动修改后，QMake会丢失依赖追踪逻辑，触发全量重建。
• 确保系统时间准确：若文件修改时间晚于当前系统时间，Make会判定文件需要重新编译，进而引发全量重建，需保证系统时间正常。

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