如何解决colcon构建多预设CMake项目时CMAKE_PROJECT_NAME缺失报错

我有一个基于preset（预设）的原生CMake项目，可通过命令cmake --preset $PRESET && cmake --build --preset $PRESET && ctest --preset $PRESET完成构建与测试。该项目可与微软Visual Studio Code CMake Tools扩展完美适配，支持构建、测试、调试及Intellisense功能。

为实现多预设并行处理，我将CMakePresets.json的binaryDir属性设置为${sourceDir}/build/${presetName}/。

我希望同时使用colcon构建该原生CMake项目，但执行colcon build --cmake-args "--preset $PRESET"时构建失败，抛出如下警告信息：

WARNING:colcon.colcon_cmake.task.cmake.build:Could not build CMake package 'root_project_name' because the CMake cache has no 'CMAKE_PROJECT_NAME' variable

上述报错中的root_project_name是顶层CMakeLists.txt内CMake project()命令传入的项目名参数，该如何消除该警告，解决后续的构建失败问题？

问题根因 #

colcon构建CMake类包时，会将流程拆分为*配置（configure）和构建（build）*两个完全独立的阶段分别调用CMake命令：

• 你通过--cmake-args传入的--preset参数，默认只会被传递到构建阶段的CMake调用中
• 配置阶段colcon不会读取CMakePresets.json的任何配置，会使用自身默认的构建路径、默认参数执行配置，生成的CMakeCache.txt和你预设要求的环境完全不匹配
• 后续构建阶段读取错误路径下的残缺缓存文件时，自然找不到CMAKE_PROJECT_NAME变量，最终触发警告和构建失败

修复步骤 #

• 分阶段给colcon传递预设参数，不要混用通用传参入口：配置阶段的参数通过--cmake-configure-args传递，构建阶段的参数通过--cmake-build-args传递
• 关闭colcon默认的CMake构建目录覆写行为，让CMake完全使用你在preset中配置的binaryDir路径，避免路径不匹配导致的缓存错位，需要添加--no-cmake-build-dir-override参数
• 首次修复构建前，清空之前错误生成的缓存目录，避免旧缓存干扰

最终可用的构建命令如下：

# 先清理旧的错误构建缓存
rm -rf build/ install/ log/

# 执行适配preset的colcon构建
colcon build \
  --no-cmake-build-dir-override \
  --cmake-configure-args "--preset $PRESET" \
  --cmake-build-args "--preset $PRESET"

执行完上述命令后，警告会完全消除，构建流程会和你原生调用CMake预设的行为完全对齐，同时保留colcon的工作空间包管理能力。如果需要频繁使用该构建方式，可以把上述参数写到colcon的defaults.yaml配置文件里，避免每次手动输入参数。

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