CMake+Ninja在不同源目录路径下如何实现增量编译

CMake生成构建缓存时会硬编码当前源目录的绝对路径做校验，源路径变更后校验不通过就会抛出你遇到的报错。手动修改CMakeCache中的路径配置会被CMake识别为全局配置变更，会标记所有编译目标为过期，自然触发全量编译。

方案1：固定源目录软链（最稳定，全版本CMake支持） #

• 提前创建一个固定路径的软链接指向当前需要编译的源目录，比如执行ln -sf /实际/当前/源目录/路径 /opt/fixed_project_source
• 首次配置时固定使用这个软链路径执行cmake /opt/fixed_project_source -B 你的固定构建目录
• 后续切换不同源目录时，只需要修改软链的指向即可，不需要重新执行cmake配置，直接运行ninja就能正常增量编译，不会触发路径校验错误

方案2：开启相对路径配置（适合构建目录和源目录相对位置固定的场景） #

• 首次执行cmake配置时添加-DCMAKE_USE_RELATIVE_PATHS=ON参数，该参数会让CMake尽量使用相对路径存储缓存配置，避免硬编码绝对路径
• 后续只要保证新的源目录和固定构建目录的相对层级和首次配置时完全一致，重新执行cmake指向新源目录时不会触发路径校验错误，也可以保留增量编译成果

方案3：使用高版本CMake的路径校验跳过参数（适合CMake 3.21及以上版本） #

• 切换源目录后重新执行cmake配置时添加-DCMAKE_IGNORE_SOURCE_DIR_CHANGE=ON参数，可以直接跳过源目录路径校验，不会触发配置全量重置，不会导致全量编译

• 不要手动修改CMakeCache.txt中的路径配置，该操作必然会触发CMake的全局配置变更检测，导致全量编译
• 以上方案都需要保证不同源目录下的同路径文件内容一致性，否则增量编译可能会出现异常

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