ROS2 Humble自定义消息无法引入：头文件找不到问题求助

1. 检查CMakeLists.txt关键配置 #

确保配置覆盖以下核心要点：

• 开头声明并引入必要依赖：

  find_package(ament_cmake REQUIRED)
  find_package(rclcpp REQUIRED)
  find_package(message_generation REQUIRED)
  

• 声明自定义消息文件并触发生成：

  add_message_files(
    FILES
    YourCustomMessage.msg  # 替换为实际的.msg文件名
  )
  
  generate_messages(
    DEPENDENCIES
    # 若消息依赖内置ROS消息（如std_msgs），在此添加对应依赖
    # std_msgs
  )
  

• 为使用自定义消息的节点添加编译依赖，确保消息先于节点编译完成：

  add_executable(my_node src/my_node.cpp)
  add_dependencies(my_node ${PROJECT_NAME}_generate_messages_cpp)
  ament_target_dependencies(my_node rclcpp ${PROJECT_NAME})
  

• 显式声明包含目录，确保能找到生成的头文件：

  include_directories(
    include
    $<BUILD_INTERFACE:${CMAKE_CURRENT_BINARY_DIR}>
  )
  

2. 验证package.xml配置 #

确保文件包含以下必要项：

<!-- 编译期依赖 -->
<build_depend>ament_cmake</build_depend>
<build_depend>rclcpp</build_depend>
<build_depend>message_generation</build_depend>

<!-- 运行期依赖 -->
<exec_depend>rclcpp</exec_depend>
<exec_depend>message_runtime</exec_depend>

<!-- 声明为ROS接口包 -->
<member_of_group>rosidl_interface_packages</member_of_group>

3. 编译与环境变量检查 #

• 先清理旧编译产物避免缓存干扰：rm -rf build install log，再重新执行colcon build
• 编译完成后必须加载环境变量：source install/setup.bash，否则系统无法识别生成的头文件路径
• VSCode中确保终端已加载ROS环境：可手动执行source命令，或在.vscode/settings.json中配置自动加载：

  "ros.distro": "humble",
  "ros.setupScript": "${workspaceFolder}/install/setup.bash"
  

4. 头文件引用正确性 #

确认代码中头文件路径与生成文件匹配：
若自定义消息属于test包，生成的头文件路径为build/test/rosidl_generator_c/test/YourCustomMessage.h，代码中需这样引用：

#include "test/YourCustomMessage.h"

而非直接写#include "YourCustomMessage.h"

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