ROS2编译报CMake自定义变量HELLO_ROS未使用警告如何解决

两个现象的本质原因非常明确：

• 跨包CMake警告：colcon build 后直接跟的 --cmake-args 参数会默认传递给工作空间内所有参与本次编译的包的CMake配置进程，realsense相关三个包没有任何逻辑引用HELLO_ROS变量，CMake检测到传入了未被使用的手动指定变量，就会抛出对应警告。
• #if 判断分支失效：直接通过target_compile_definitions传入HELLO_ROS=${HELLO_ROS}时，若CMake变量HELLO_ROS=ON，最终传给编译器的宏定义为HELLO_ROS=ON。C/C++预处理器的#if指令要求后续参数为可计算的整型常量表达式，ON是CMake自定义的布尔字符串，不是预定义的宏或整型值，预处理器会将无法识别的标识符默认按0处理，因此走到#else分支；而#ifdef仅判断宏是否被定义，不校验宏的具体值，因此可以正常触发。

修复宏判断逻辑失效问题 #

二选一即可，推荐第一种：

• 适配#if HELLO_ROS判断逻辑：使用CMake布尔生成器表达式将CMake布尔值转换为C/C++可识别的整型1/0，修改target_compile_definitions写法：

  target_compile_definitions(composition_nodes PRIVATE HELLO_ROS=$<BOOL:${HELLO_ROS}>)
  

  该写法在CMake 3.16版本下完全兼容，传入-DHELLO_ROS=ON时最终传给编译器的定义为HELLO_ROS=1，传入OFF时为HELLO_ROS=0，#if判断可正常生效。
• 适配#ifdef HELLO_ROS判断逻辑：回退为条件追加宏定义的写法，不给宏赋值：

  option(HELLO_ROS "Enable custom hello log" OFF)
  if(HELLO_ROS)
    target_compile_definitions(composition_nodes PRIVATE HELLO_ROS)
  endif()
  

消除未使用变量CMake警告 #

核心原则是不要将单个包专属的编译参数全局透传给所有包，按优先级选方案：

1. 包专属传参（最推荐，零侵入第三方包）：使用colcon的分包包参数传递语法，仅将HELLO_ROS参数传给需要它的minimal_composition包，示例命令：

   colcon build --cmake-args -DCMAKE_BUILD_TYPE=Release -- minimal_composition --cmake-args -DHELLO_ROS=ON
   

   语法规则为-- <目标包名> --cmake-args <该包专属参数>，该写法下HELLO_ROS不会被传递给realsense相关包，从根源上避免未使用变量警告，且不需要修改任何第三方包的配置文件。
2. 单包编译（适合调试阶段）：如果当前仅需要调试minimal_composition包，可直接指定仅编译该包，realsense相关包不会触发重新配置，自然不会产生警告：

   colcon build --packages-select minimal_composition --cmake-args -DHELLO_ROS=ON
   

3. 第三方包声明参数（不推荐，侵入第三方配置）：如果需要全局传参且不想修改编译命令，可在三个realsense包的CMakeLists.txt最顶部添加参数声明，让CMake识别该参数为合法传入参数，就不会触发警告：

   set(HELLO_ROS OFF CACHE BOOL "Global hello ros flag" FORCE)
   

注意：不要通过添加--no-warn-unused-cli参数全局屏蔽CMake未使用变量警告，该操作会同时屏蔽因参数拼写错误、参数名写错导致的有效警告，大幅提升后续编译问题排查成本。

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