ROS2 Jazzy 包管理极简实战创建、编译、运行一条龙本文基于ROS2 Jazzy Ubuntu 24.04演示如何用命令行快速创建 C/Python 功能包、编译、查询信息并运行节点。适合刚装好 Jazzy、想快速跑通包管理流程的同学。一、环境准备先确认已安装ROS2 Jazzy和colconsource/opt/ros/jazzy/setup.bashsudoaptinstallpython3-colcon-common-extensions验证环境ros2--versioncolcon--version如果能看到 Jazzy 版本号说明环境正常。二、创建工作空间mkdir-p~/ros2_ws/srccd~/ros2_ws/srcROS2 的功能包通常放在工作空间的src目录下。三、创建功能包1. 创建 C 包ros2 pkg create my_cpp_pkg\--build-type ament_cmake\--dependenciesrclcpp std_msgs生成的目录结构大致如下my_cpp_pkg/ ├── CMakeLists.txt ├── package.xml └── src/2. 创建 Python 包ros2 pkg create my_py_pkg\--build-type ament_python\--dependenciesrclpy生成的目录结构大致如下my_py_pkg/ ├── my_py_pkg/ │ └── __init__.py ├── package.xml ├── setup.py └── setup.cfg四、编译功能包回到工作空间根目录cd~/ros2_ws只编译指定包节省时间colcon build --packages-select my_cpp_pkg colcon build --packages-select my_py_pkg --symlink-install其中--symlink-install对 Python 包特别有用修改代码后通常不需要重新编译。编译完成后刷新环境sourceinstall/setup.bash五、查询包信息1. 查看所有包ros2 pkg list可以配合grep过滤ros2 pkg list|grepmy_2. 查看包安装路径ros2 pkg prefix my_py_pkg3. 查看包里的可执行文件ros2 pkg executables my_py_pkg如果 C 包还没有注册可执行文件ros2 pkg executables my_cpp_pkg可能没有输出这是正常现象。六、运行 Python 节点示例在my_py_pkg/my_py_pkg/目录下创建文件nano~/ros2_ws/src/my_py_pkg/my_py_pkg/hello.py写入importrclpyfromrclpy.nodeimportNodeclassHelloNode(Node):def__init__(self):super().__init__(hello_node)self.get_logger().info(Hello ROS2 Jazzy)defmain():rclpy.init()nodeHelloNode()node.destroy_node()rclpy.shutdown()if__name____main__:main()编辑setup.py在entry_points中添加entry_points{console_scripts:[hello my_py_pkg.hello:main,],},重新编译并运行cd~/ros2_ws colcon build --packages-select my_py_pkg --symlink-installsourceinstall/setup.bash ros2 run my_py_pkg hello终端输出类似[INFO] [hello_node]: Hello ROS2 Jazzy七、常用命令速查用途命令创建 C 包ros2 pkg create --build-type ament_cmake创建 Python 包ros2 pkg create --build-type ament_python编译指定包colcon build --packages-select pkg软链接安装colcon build --symlink-install查看所有包ros2 pkg list查看包路径ros2 pkg prefix pkg查看可执行文件ros2 pkg executables pkg运行节点ros2 run pkg executable八、常见问题找不到包编译后需要执行source install/setup.bash。找不到可执行文件Python 包需要在setup.py的entry_points中注册C 包需要在CMakeLists.txt中用add_executable注册。Python 修改不生效建议使用--symlink-install编译修改后通常无需重新编译。colcon 命令不存在执行sudo apt install python3-colcon-common-extensions安装。
