ROS 2 Humble 在 Ubuntu 22.04 环境配置：3步完成基础安装与首个节点测试

ROS 2 Humble 极速上手指南Ubuntu 22.04 环境配置与首个节点实战当现代机器人技术遇上分布式计算框架ROS 2正在重新定义智能设备的开发范式。作为机器人开发领域的瑞士军刀Humble Hawksbill版本以其卓越的稳定性和对Ubuntu 22.04的原生支持成为2023年最值得投入学习的机器人操作系统。本文将带您跳过繁琐的理论讲解直接进入实战环节——从零开始搭建开发环境到运行第一个通信节点整个过程仅需30分钟。1. 环境准备系统配置与依赖安装在开始ROS 2 Humble的安装之前我们需要确保Ubuntu 22.04系统处于最佳状态。建议使用全新安装的Jammy Jellyfish版本避免与其他软件包产生冲突。打开终端CtrlAltT依次执行以下命令更新系统sudo apt update sudo apt upgrade -y sudo apt install curl gnupg2 lsb-releaseROS 2 Humble需要UTF-8编码环境通过以下命令设置区域配置sudo apt install locales sudo locale-gen en_US en_US.UTF-8 sudo update-locale LC_ALLen_US.UTF-8 LANGen_US.UTF-8 export LANGen_US.UTF-8接下来添加ROS 2 apt仓库到系统源列表。请注意以下命令中的architecture需要替换为您的CPU架构通常amd64或arm64sudo curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key -o /usr/share/keyrings/ros-archive-keyring.gpg echo deb [arch$(dpkg --print-architecture) signed-by/usr/share/keyrings/ros-archive-keyring.gpg] http://packages.ros.org/ros2/ubuntu $(source /etc/os-release echo $UBUNTU_CODENAME) main | sudo tee /etc/apt/sources.list.d/ros2.list /dev/null安装基础开发工具和ROS 2核心组件sudo apt update sudo apt install -y ros-humble-desktop python3-argcomplete提示如果网络连接不稳定可以考虑使用国内镜像源。将上述URL中的packages.ros.org替换为mirrors.tuna.tsinghua.edu.cn/ros2可显著提升下载速度。验证安装是否成功的最快方法是检查ROS 2环境变量是否已配置source /opt/ros/humble/setup.bash printenv | grep ROS正常情况应该显示如下环境变量ROS_VERSION2ROS_PYTHON_VERSION3ROS_DISTROhumble2. 创建工作空间与示例程序ROS 2采用colcon作为构建工具比传统catkin更高效。首先安装必要的构建工具sudo apt install python3-colcon-common-extensions创建并初始化工作空间mkdir -p ~/ros2_ws/src cd ~/ros2_ws colcon build让我们创建一个简单的发布者(Publisher)和订阅者(Subscriber)示例。在src目录下新建功能包ros2 pkg create --build-type ament_python py_pubsub --dependencies rclpy std_msgs编辑~/ros2_ws/src/py_pubsub/py_pubsub/publisher_member_function.py文件输入以下内容import rclpy from rclpy.node import Node from std_msgs.msg import String class MinimalPublisher(Node): def __init__(self): super().__init__(minimal_publisher) self.publisher_ self.create_publisher(String, topic, 10) timer_period 0.5 self.timer self.create_timer(timer_period, self.timer_callback) self.i 0 def timer_callback(self): msg String() msg.data Hello World: %d % self.i self.publisher_.publish(msg) self.get_logger().info(Publishing: %s % msg.data) self.i 1 def main(argsNone): rclpy.init(argsargs) minimal_publisher MinimalPublisher() rclpy.spin(minimal_publisher) minimal_publisher.destroy_node() rclpy.shutdown() if __name__ __main__: main()同样地创建订阅者脚本subscriber_member_function.pyimport rclpy from rclpy.node import Node from std_msgs.msg import String class MinimalSubscriber(Node): def __init__(self): super().__init__(minimal_subscriber) self.subscription self.create_subscription( String, topic, self.listener_callback, 10) self.subscription def listener_callback(self, msg): self.get_logger().info(I heard: %s % msg.data) def main(argsNone): rclpy.init(argsargs) minimal_subscriber MinimalSubscriber() rclpy.spin(minimal_subscriber) minimal_subscriber.destroy_node() rclpy.shutdown() if __name__ __main__: main()修改setup.py文件确保入口点配置正确entry_points{ console_scripts: [ talker py_pubsub.publisher_member_function:main, listener py_pubsub.subscriber_member_function:main, ], }3. 构建与运行测试现在可以构建我们的功能包了。在workspace根目录执行colcon build --packages-select py_pubsub构建完成后需要source安装空间的环境配置source install/setup.bash启动发布者节点ros2 run py_pubsub talker在另一个终端中启动订阅者节点source ~/ros2_ws/install/setup.bash ros2 run py_pubsub listener如果一切正常您将在发布者终端看到类似以下输出[INFO] [minimal_publisher]: Publishing: Hello World: 0 [INFO] [minimal_publisher]: Publishing: Hello World: 1同时在订阅者终端看到对应的接收消息[INFO] [minimal_subscriber]: I heard: Hello World: 0 [INFO] [minimal_subscriber]: I heard: Hello World: 14. 进阶调试与工具链ROS 2提供了一系列强大的调试工具。要查看当前活动的节点列表ros2 node list查看节点间的通信拓扑ros2 topic list ros2 topic echo /topic对于更复杂的系统监控可以使用rqt工具sudo apt install ros-humble-rqt rqt在rqt界面中通过Plugins Introspection Node Graph可以可视化节点间的通信关系。以下是一个常用工具对比表工具名称安装命令主要功能rqt_graph内置工具可视化节点通信拓扑ros2bagros-humble-ros2bag消息记录与回放rviz2ros-humble-rviz23D可视化与传感器数据显示turtlesimros-humble-turtlesim基础教学模拟环境当需要调试复杂系统时可以考虑使用launch文件。创建一个新的launch文件~/ros2_ws/src/py_pubsub/launch/pubsub_launch.pyfrom launch import LaunchDescription from launch_ros.actions import Node def generate_launch_description(): return LaunchDescription([ Node( packagepy_pubsub, executabletalker, namedemo_publisher ), Node( packagepy_pubsub, executablelistener, namedemo_subscriber ) ])运行launch文件ros2 launch py_pubsub pubsub_launch.py