ROS2 功能包创建与 CMake 编译链路详解

--dependencies 参数用于指定功能包依赖的其他 ROS2 包，创建包时会自动将依赖写入 package.xml 和 CMakeLists.txt，避免手动配置依赖导致的编译错误，是开发中最常用的参数之一。

常见依赖包括：

• rclcpp：C++ 节点开发核心依赖
• rclpy：Python 节点开发核心依赖
• std_msgs：标准消息类型依赖（如 String、Int32）
• sensor_msgs：传感器消息依赖（如激光雷达、IMU 数据）
• geometry_msgs：几何消息依赖（如速度、姿态、坐标）
• rosidl_default_generators：自定义消息（.msg/.srv）编译依赖

ros2 pkg create my_nav_pkg --build-type ament_cmake --dependencies rclcpp std_msgs sensor_msgs

典型场景示例

创建基础 C++ 包

ros2 pkg create my_cpp_node \
  --build-type ament_cmake \
  --dependencies rclcpp std_msgs \
  --node-name my_first_node \
  --description "ROS2 C++ 基础节点包，用于演示简单消息发布" \
  --license MIT \
  --maintainer "Zhang San" \
  --maintainer-email "[email protected]" \
  --destination-directory ./src

创建基础 Python 包

ros2 pkg create my_py_node \
  --build-type ament_python \
  --dependencies rclpy \
  --node-name my_py_node \
  --description "ROS2 Python 基础节点包" \
  --license Apache-2.0

创建自定义消息接口包

ros2 pkg create my_custom_msgs \
  --build-type ament_cmake \
  --dependencies rosidl_default_generators std_msgs \
  --description "ROS2 自定义消息包，用于定义专属消息类型" \
  --license MIT

创建导航相关 C++ 包

ros2 pkg create my_navigation \
  --build-type ament_cmake \
  --dependencies rclcpp geometry_msgs nav2_msgs sensor_msgs \
  --description "ROS2 导航功能包，用于机器人路径规划与控制" \
  --destination-directory ./src

CMakeLists.txt 相关语法

CMakeLists.txt 是 ROS2 C++ 功能包（ament_cmake 类型）的核心构建配置文件，负责定义编译规则、依赖管理、目标安装等。

• find_package(<依赖包> REQUIRED) 查找当前功能包依赖的 ROS2 包或第三方库，REQUIRED 表示该依赖是必需的，找不到会直接报错；若依赖多个包，可分多行书写。

  find_package(ament_cmake REQUIRED)
  find_package(rclcpp REQUIRED)
  find_package(std_msgs REQUIRED)
  

• ament_package() ROS2 专属核心指令，标记当前包为 ament 包，用于生成 package.xml 关联配置、注册包到 ament 索引，必须放在 CMakeLists.txt 的最后一行，且每个包只能调用一次。

• add_executable(<节点名> <源码路径>) 将指定的 C++ 源码文件编译为可执行节点，<节点名> 是编译后生成的可执行文件名称，<源码路径> 是 .cpp 文件的相对路径（通常在 src 目录下），这是最后可以 ros2 run 的依据。

  add_executable(talker src/talker.cpp)
  

• ament_target_dependencies(<节点名> <依赖包>...) 为可执行节点或库绑定依赖包，自动处理依赖包的头文件路径和编译宏，替代传统的 target_include_directories 指令，简化配置，必须在 add_executable 之后调用。

  ament_target_dependencies(talker rclcpp std_msgs)
  

• target_link_libraries(<节点名> <库文件>...) 将指定的库文件（如自定义消息类型支持库、第三方库）链接到可执行节点，常用于链接自定义消息的类型支持库。

• rosidl_generate_interfaces(<包名> <消息文件> [DEPENDENCIES <依赖包>]) ROS2 自定义消息（.msg/.srv/.action）编译核心指令，用于解析消息文件、生成对应的 C++/Python 代码和头文件，若消息依赖其他包（如 std_msgs），需通过 DEPENDENCIES 声明。

  rosidl_generate_interfaces(${PROJECT_NAME} msg/MyMsg.msg DEPENDENCIES std_msgs)
  

• rosidl_get_typesupport_target(<变量名> <包名> "rosidl_typesupport_cpp") 查找当前包生成的自定义消息 C++ 类型支持库，将其赋值给指定变量，便于后续通过 target_link_libraries 链接到节点，是 ROS2 Humble 及以后的推荐写法。

• install(TARGETS <节点名/库名> DESTINATION <路径>) 该命令是将生成的可执行节点安装在指定路径，这是后续 ros2 run xxx 的关键，ROS2 规范路径为 lib/${PROJECT_NAME}（节点/库）、include/${PROJECT_NAME}（头文件）。

package.xml 相关语法

package.xml 是 ROS2 功能包的元数据配置文件，用于声明包的基本信息、依赖关系、维护者信息等，ROS2 编译工具（colcon）通过该文件识别包的类型、依赖和构建规则。

基础信息标签

依赖关系标签

• <buildtool_depend> 构建工具依赖，声明构建该包所需的工具包，C++ 包默认依赖 ament_cmake，Python 包默认依赖 ament_python，是必需依赖。

  <buildtool_depend>ament_cmake</buildtool_depend>
  

• <build_depend> 构建依赖，声明编译该包时所需的依赖包（如头文件、编译宏），仅在构建阶段生效，运行时无需依赖。

  <build_depend>rclcpp</build_depend>
  

• <exec_depend> 执行依赖，声明运行该包时所需的依赖包（如库文件、节点），仅在运行阶段生效，构建时无需依赖。

  <exec_depend>std_msgs</exec_depend>
  

• <depend> 通用依赖，等价于同时声明 build_depend、exec_depend 和 test_depend，适用于'构建、运行、测试都需要'的依赖，简化配置。

  <depend>rclcpp</depend>
  

• <test_depend> 测试依赖，声明运行包的测试用例时所需的依赖包（如 gtest、ament_lint_auto），仅在测试阶段生效。

  <test_depend>ament_lint_auto</test_depend>
  <test_depend>ament_lint_common</test_depend>
  

• <member_of_group> 将包归类到指定组，ROS2 自定义消息包必须添加该标签，值为 rosidl_interface_packages，告诉编译系统该包是接口包。

  <member_of_group>rosidl_interface_packages</member_of_group>