在 ROS2 开发中，ros2 pkg create 是初始化功能包的核心工具。它不仅能自动生成符合规范的目录结构，还能预设配置文件和示例节点，省去了手动搭建环境的繁琐步骤。无论是 C++ 还是 Python 节点，掌握这个命令都能显著提升开发效率。
搭建工作空间
我们通常先在工作区根目录下创建一个新文件夹，并包含 src 子目录。这是 ROS2 的标准布局，方便后续使用 colcon 进行构建。
mkdir -p test_ws/src && cd test_ws/src
功能包创建参数解析
基础语法
基本命令格式如下，其中 <功能包名称> 是必填项，需遵循小写加下划线的命名规范：
ros2 pkg create [可选参数] <功能包名称>
核心配置项
- 构建类型：通过
--build-type指定。ament_cmake用于 C++ 项目，默认生成CMakeLists.txt；ament_python用于 Python 项目，生成setup.py等文件。 - 依赖管理：使用
--dependencies声明所需的其他 ROS2 包（如rclcpp,std_msgs）。这会自动将依赖写入package.xml和CMakeLists.txt，避免编译时找不到头文件。 - 元数据：
--description描述包的用途，--license设定开源协议（如 MIT, Apache-2.0），--maintainer填写维护者信息。
实战示例
创建一个基础的 C++ 发布节点，需要引入 rclcpp 和 std_msgs：
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 "Your Name"
若涉及自定义消息或导航功能，只需调整依赖列表即可。例如导航包通常需要 geometry_msgs 和 nav2_msgs。
CMakeLists.txt 构建规则
对于 C++ 功能包，CMakeLists.txt 定义了编译逻辑。理解以下指令有助于排查构建错误：
- 查找依赖：
find_package(<包名> REQUIRED)告诉 CMake 去哪里找库文件。如果找不到且标记为 REQUIRED，构建会直接失败。 - 定义目标：
add_executable(<节点名> <源码路径>)将.cpp文件编译成可执行文件。这里的节点名就是后续ros2 run时使用的标识。 - 绑定依赖：
ament_target_dependencies(<节点名> <依赖包>)是关键一步，它自动处理了头文件路径和链接库，比传统的target_include_directories更简洁。 - 安装规则：
install(TARGETS ... DESTINATION lib/${PROJECT_NAME})确保生成的二进制文件能被系统找到。这是ros2 run能成功执行的前提。 - 自定义消息：如果有
.msg文件，必须使用rosidl_generate_interfaces生成对应的代码，并通过rosidl_get_typesupport_target获取类型支持库进行链接。
package.xml 元数据配置
package.xml 是功能包的身份证，记录了版本、作者和依赖关系。colcon 构建器依赖此文件识别包的类型。
| 标签 | 说明 |
|---|---|
| name | 包名，必须与 CMakeLists.txt 中的 project() 一致 |
| version | 语义化版本号，如 1.0.0 |
| maintainer | 维护者姓名及邮箱 |
| license | 开源协议，如 MIT |
| depend | 通用依赖，同时包含构建和执行依赖 |
| buildtool_depend | 构建工具依赖，C++ 包通常为 ament_cmake |
特别注意，如果是自定义消息接口包，必须添加 <member_of_group>rosidl_interface_packages</member_of_group> 标签，否则编译系统无法识别其为接口包。
通过合理配置这两个核心文件，你的 ROS2 功能包就能顺利进入编译运行阶段。在实际开发中，建议多参考官方文档中的标准模板，减少因配置遗漏导致的编译问题。
