CMake构建进度卡在40%但仍能完成构建的问题求助

问题现象 #

• 构建过程中进度持续停留在40%，重复输出[build] [ 40%] ...，但最终能顺利完成全部构建任务。

常见原因及解决办法 #

• 单个大目标编译耗时过长：40%对应的可能是某个包含大量代码的库或可执行文件，CMake在编译这类大型目标时，不会逐文件更新进度百分比，直到整个目标编译完成才会跳转进度。这属于正常情况，无需干预，等待该目标编译结束即可。
• CMake进度计算逻辑限制：CMake的进度百分比是按目标数量统计，而非代码量或编译时长。如果某个阶段的目标数量占比低，但单个目标编译耗时极长，就会出现进度“停滞”的视觉效果。可以通过两种方式优化：
  • 执行cmake --build . --verbose查看详细编译日志，实时追踪当前编译的文件，确认构建仍在正常推进。
  • 修改CMakeLists.txt，将大型目标拆分为多个小型子目标，让进度百分比能更平滑地更新。
• 日志输出缓冲导致显示延迟：部分终端或构建工具存在输出缓冲，进度信息无法实时刷新。可以尝试关闭输出缓冲，或者直接查看构建目录下的日志文件确认实际进度。

验证构建是否正常进行 #

执行cmake --build . --parallel N（N为你的CPU核心数）开启并行编译，同时用watch -n 1 ls -la <构建目录>/<目标文件路径>命令，实时查看目标文件的大小变化，以此确认编译仍在持续进行。

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