为何CMake会链接不存在的Debug版本fastcdrd-1.0.lib文件？

问题背景 #

在Visual Studio中编译ROS2 Humble节点（未使用colcon build，集成自有C++编译框架），添加自定义.msg并更新CMakeLists.txt后，仅Release模式可正常编译，Debug模式下my_package__rosidl_typesupport_fastrtps_c/cpp项目触发LNK1104错误，提示无法打开fastcdrd-1.0.lib。同时发现：

• ROS2目录下的FindFastRTPS.cmake包含查找fastcdrd-${fastcdr_MAJOR_MINOR_VERSION}的逻辑，但该文件未被加载
• Debug模式链接选项实际指向fastcdr-1.0.lib，而非错误提示中的fastcdrd-1.0.lib

核心原因与解决步骤 #

1. ROS2预编译包缺失Debug版本的FastCDR库 #

部分ROS2 Windows预编译包仅默认提供Release版本依赖库，未包含Debug版本的fastcdrd-1.0.lib：

• 检查路径C:\ROS2\ros2-windows\lib，确认是否存在fastcdrd-1.0.lib：
  • 若不存在，需自行编译FastCDR的Debug版本，或更换包含Debug依赖的ROS2安装包
  • 若存在，继续排查后续配置问题

2. FindFastRTPS.cmake未被正确加载 #

ROS2的FastRTPS依赖配置未被CMake识别，导致Debug模式的库查找逻辑未生效：

• 在自定义CMakeLists.txt中，确保添加ROS2的CMake模块路径，并显式查找FastRTPS：

  # 添加ROS2模块路径
  set(CMAKE_MODULE_PATH "${CMAKE_MODULE_PATH};C:/ROS2/ros2-windows/share/FastRTPS/cmake")
  # 显式查找FastRTPS依赖
  find_package(FastRTPS REQUIRED)
  

• 检查VS的Debug模式环境变量，确认已加载ROS2的Debug环境脚本（ros2-windows\local_setup_debug.bat），而非Release版本的local_setup.bat

3. rosidl生成代码的库名配置混淆 #

自定义Msg生成的rosidl支持代码中，Debug模式的库名规则与实际ROS2库命名不匹配：

• 查看my_package__rosidl_typesupport_fastrtps_c/cpp项目的CMakeLists.txt，检查是否硬编码了带d后缀的库名。若ROS2提供的Debug库无d后缀（即实际为fastcdr-1.0.lib），需手动覆盖Debug模式的库路径：

  if(CMAKE_BUILD_TYPE STREQUAL "Debug")
    # 强制指定Debug模式使用的FastCDR库文件
    set(FastCDR_LIBRARY_DEBUG "${CMAKE_PREFIX_PATH}/lib/fastcdr-1.0.lib")
  endif()
  

4. CMake Debug模式配置未正确传递 #

自有编译框架可能未将Debug模式的配置正确传递给rosidl的生成流程：

• 确保在触发CMake生成时，明确指定CMAKE_BUILD_TYPE=Debug：

  cmake -S . -B build -DCMAKE_BUILD_TYPE=Debug
  

• 在VS中，确认项目的“调试”配置中，CMake的Build Type已设置为Debug，且所有依赖的配置均同步为Debug模式

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