这次我们来看 ROS2 机器人操作系统中的“小海龟”实验。对于任何学习 ROS2 的人来说小海龟turtlesim都是绕不开的第一个实操项目。它不是一个复杂的机器人而是一个简单的图形化仿真器但麻雀虽小五脏俱全。通过它你可以快速理解 ROS2 最核心的概念节点Node、话题Topic、服务Service、动作Action和参数Parameter。这篇文章不讲复杂的理论直接带你从零开始在 Ubuntu 22.04 上完成 ROS2 Humble 的安装并一步步运行和操控小海龟验证 ROS2 的核心通信机制是否正常工作。如果你关心 ROS2 的环境搭建是否顺利、基础命令是否有效、以及如何通过键盘或程序控制小海龟那么这篇文章可以直接跟着操作。我们将重点关注实操过程从系统环境准备、ROS2 安装包括使用国内源加速到启动 turtlesim 节点、查看话题列表、发布速度指令最后编写一个简单的 Python 节点来控制小海龟画圆。整个过程会清晰展示 ROS2 的“发布-订阅”模型如何运作。无论你是 ROS1 的老用户想过渡到 ROS2还是完全的机器人开发新手这个实验都是最佳的入门起点。1. 核心能力速览在深入操作之前我们先通过一个表格快速了解“小海龟实验”所涉及的核心技术和能力边界这有助于你判断接下来的内容是否是你需要的。能力项说明实验目标理解 ROS2 节点、话题、服务、参数等核心概念并通过图形化仿真进行验证。核心组件turtlesim仿真器包包含仿真节点、键盘控制节点等。硬件门槛极低。主要依赖 CPU 进行仿真无需 GPU普通台式机或笔记本电脑即可。系统要求推荐 Ubuntu 22.04 LTS。这是 ROS2 Humble Hawksbill 的官方支持系统。也支持在 WSL2 (Windows Subsystem for Linux) 或 Docker 中运行。ROS2 版本本文以ROS2 Humble为例这是当前的长期支持版本LTS文档和社区支持最完善。启动方式通过命令行终端使用ros2 run命令启动各个功能节点。交互方式1. 命令行工具ros2 topic pub,ros2 service call2. 键盘实时控制turtle_teleop_key3. 自定义 Python/C 节点编程控制。验证重点节点间通信是否正常、话题消息能否收发、服务调用是否成功、参数动态配置是否生效。适合场景ROS2 初学者入门、验证 ROS2 安装是否成功、快速测试自定义节点的基础通信功能。2. 适用场景与使用边界小海龟实验虽然简单但应用场景明确理解其边界能帮助你更好地利用它。它非常适合ROS2 零基础入门无需真实机器人硬件通过图形化反馈直观理解抽象概念。环境验证在安装完 ROS2 或配置新开发环境后运行小海龟是检验系统是否就绪的“标准动作”。通信机制学习它是学习rostopic、rosservice、ros2 param等命令行工具的最佳教具。算法原型验证在将控制算法部署到真实机器人前可先用小海龟验证逻辑是否正确例如 PID 控制、路径规划等。教学与演示由于其可视化特性非常适合用于课堂或技术分享。它不适合高性能仿真turtlesim不涉及物理引擎如 Gazebo无法模拟机器人动力学、传感器噪声、复杂环境交互。真实机器人建模它只是一个简单的二维乌龟图标无法替代 URDF 模型和 RViz2/Gazebo 等工具进行机器人本体建模与仿真。复杂系统测试对于多机器人协作、SLAM、导航栈等需要复杂传感器和环境的测试需要移步到更高级的仿真工具。合规与安全提醒turtlesim是 ROS2 官方提供的开源仿真工具完全免费且仅用于学习和测试。其中不涉及任何真实数据、隐私信息或受版权保护的模型可放心使用。3. 环境准备与前置条件为了顺利完成实验请确保你的开发环境满足以下要求。我们将以最常用的 Ubuntu 22.04 原生系统为例进行说明。操作系统Ubuntu 22.04 LTS (Jammy Jellyfish)。这是 ROS2 Humble 的“官配”。你可以在虚拟机、物理机或 WSL2 中安装。系统更新在安装任何新软件前建议先更新系统软件包列表。sudo apt update sudo apt upgrade -y区域设置确保你的 locale 支持 UTF-8这对于 ROS2 的某些工具有影响。sudo apt install locales -y 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你可以将en_US替换为zh_CN等但英文环境可以避免一些潜在的编码问题。基础工具安装一些必要的编译工具和软件源管理工具。sudo apt install software-properties-common curl git wget build-essential -y4. ROS2 Humble 安装部署ROS2 的安装有多种方式包括二进制包安装、从源码编译等。对于初学者和大多数开发场景通过APT二进制包安装是最简单、最稳定的方式。为了加速下载我们将使用国内镜像源。4.1 设置软件源首先将 ROS2 的软件仓库添加到你的系统。确保已启用 Ubuntu Universe 仓库sudo apt install software-properties-common sudo add-apt-repository universe添加 ROS2 GPG 密钥sudo curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key -o /usr/share/keyrings/ros-archive-keyring.gpg将 ROS2 仓库源添加到系统。这里使用国内清华大学镜像源以大幅提升下载速度echo deb [arch$(dpkg --print-architecture) signed-by/usr/share/keyrings/ros-archive-keyring.gpg] https://mirrors.tuna.tsinghua.edu.cn/ros2/ubuntu $(lsb_release -cs) main | sudo tee /etc/apt/sources.list.d/ros2.list /dev/null命令中的$(lsb_release -cs)会自动获取你的 Ubuntu 代号如jammy。4.2 安装 ROS2 基础包更新软件包列表并安装 ROS2。我们安装桌面完整版ros-humble-desktop它包含了 ROS2、RViz2、示例等几乎所有常用工具。sudo apt update sudo apt install ros-humble-desktop -y安装过程可能需要一些时间请耐心等待。如果网络不稳定可以重复执行sudo apt update和安装命令。4.3 配置环境变量安装完成后需要将 ROS2 的 setup 脚本添加到你的 shell 启动文件中这样每次打开新终端都能自动配置好 ROS2 环境。对于 bash 用户echo source /opt/ros/humble/setup.bash ~/.bashrc source ~/.bashrc对于 zsh 用户echo source /opt/ros/humble/setup.zsh ~/.zshrc source ~/.zshrc4.4 安装额外依赖可选但推荐安装一些常用的 ROS2 工具和编译工具方便后续开发sudo apt install python3-colcon-common-extensions python3-rosdep2 python3-argcomplete -y初始化rosdep它用于安装工作空间中的包依赖sudo rosdep init rosdep update至此ROS2 Humble 已安装完毕。你可以通过以下命令验证核心组件是否安装成功ros2 --version如果输出版本号如ros2 version 0.20.0则说明安装成功。5. 小海龟实验功能测试与效果验证环境就绪现在进入正题。我们将通过一系列由浅入深的操作彻底玩转小海龟。5.1 启动 turtlesim 仿真器打开第一个终端我们称之为终端1运行以下命令启动小海龟仿真器节点ros2 run turtlesim turtlesim_node如果一切正常你会看到一个蓝色背景的窗口弹出窗口中央有一只可爱的卡通小海龟。这个窗口就是一个 ROS2节点它订阅速度指令话题并控制海龟的移动和显示。5.2 查看系统状态不要关闭 turtlesim 窗口。打开第二个终端终端2我们来查看一下当前 ROS2 系统的状态。查看活动节点列表ros2 node list你应该能看到一个名为/turtlesim的节点。这就是我们刚刚启动的仿真器。查看节点详情ros2 node info /turtlesim这个命令会打印出/turtlesim节点的详细信息包括它发布Publishes了哪些话题、订阅Subscribes了哪些话题、提供了哪些服务Services等。这是理解节点功能的关键命令。查看所有话题ros2 topic list你会看到类似/turtle1/cmd_vel,/turtle1/color_sensor,/turtle1/pose等话题。其中/turtle1/cmd_vel就是用来控制海龟速度的话题。5.3 通过命令行控制小海龟现在我们尝试通过命令行直接向速度话题发布消息来控制小海龟移动。在终端2中运行以下命令ros2 topic pub --once /turtle1/cmd_vel geometry_msgs/msg/Twist {linear: {x: 2.0, y: 0.0, z: 0.0}, angular: {x: 0.0, y: 0.0, z: 1.8}}命令解析ros2 topic pub发布消息到指定话题。--once只发布一次消息。/turtle1/cmd_vel目标话题。geometry_msgs/msg/Twist消息类型表示包含线速度和角速度的速度指令。{linear: {x: 2.0, ...}, angular: {...}}消息的具体内容。这里表示让海龟以 2.0 m/s 的线速度前进同时以 1.8 rad/s 的角速度旋转。执行后观察终端1的 turtlesim 窗口小海龟应该会向前移动并转弯。这就是 ROS2话题通信的典型过程一个节点你的终端发布消息另一个节点turtlesim订阅并处理该消息。5.4 通过键盘实时控制命令行发布一次指令不够方便。ROS2 提供了一个键盘控制节点。在终端2中按CtrlC停止上一个命令然后运行ros2 run turtlesim turtle_teleop_key终端会提示你使用键盘上的方向键或 WASD来控制海龟。现在你就可以像玩游戏一样实时控制小海龟在窗口中移动了。这背后依然是turtle_teleop_key节点在持续向/turtle1/cmd_vel话题发布速度消息。5.5 查看实时数据流打开第三个终端终端3我们可以“偷听”话题上流动的数据。查看海龟的实时位姿ros2 topic echo /turtle1/pose这个命令会持续打印出海龟的x,y坐标、朝向角度theta以及线速度和角速度。移动海龟观察数据的变化。查看速度指令ros2 topic echo /turtle1/cmd_vel在终端2用键盘控制海龟时这里会实时显示你发出的速度指令。5.6 使用服务Service服务是 ROS2 中另一种同步的请求-响应通信模式。turtlesim提供了一些服务例如生成一只新海龟。查看可用服务ros2 service list调用生成新海龟的服务ros2 service call /spawn turtlesim/srv/Spawn {x: 5.5, y: 5.5, theta: 0.0, name: my_turtle2}执行后turtlesim 窗口中会出现第二只名为my_turtle2的海龟。服务的调用是同步的你会立刻收到一个包含新海龟名字的响应。5.7 使用参数Parameter参数是节点运行时可以动态配置的变量。turtlesim节点有一个背景颜色参数。列出节点参数ros2 param list /turtlesim你会看到background_b,background_g,background_r等参数。获取参数值ros2 param get /turtlesim background_r设置参数值改变背景色ros2 param set /turtlesim background_r 150执行后turtlesim 窗口的背景红色分量会立即改变。你可以尝试修改background_g和background_b来混合出不同的背景色。6. 编写自定义节点控制小海龟通过命令行工具体验后我们来点更深入的编写一个 Python 节点让程序自动控制小海龟画一个正方形。这是将 ROS2 知识应用于实际编程的关键一步。6.1 创建工作空间和功能包首先创建一个 ROS2 工作空间和功能包来管理我们的代码。# 创建并进入工作空间目录 mkdir -p ~/turtle_ws/src cd ~/turtle_ws/src # 创建 Python 功能包依赖 rclpy 和 turtlesim ros2 pkg create my_turtle_controller --build-type ament_python --dependencies rclpy turtlesim cd ~/turtle_ws6.2 编写画正方形节点进入功能包的 Python 脚本目录创建我们的控制节点文件。cd ~/turtle_ws/src/my_turtle_controller/my_turtle_controller touch draw_square.py chmod x draw_square.py用文本编辑器如nano,vim或gedit打开draw_square.py输入以下代码#!/usr/bin/env python3 import rclpy from rclpy.node import Node from geometry_msgs.msg import Twist import time class DrawSquareNode(Node): def __init__(self): super().__init__(draw_square_node) # 创建发布者向 /turtle1/cmd_vel 话题发布 Twist 消息 self.publisher_ self.create_publisher(Twist, /turtle1/cmd_vel, 10) self.timer self.create_timer(0.1, self.timer_callback) # 0.1秒触发一次 self.side_length 2.0 # 正方形边长 self.duration_move 2.0 # 移动一边所需时间 self.duration_turn 1.57 # 旋转90度所需时间 (约1.57秒) self.start_time self.get_clock().now() self.state MOVE_FORWARD # 初始状态向前移动 self.side_count 0 def timer_callback(self): msg Twist() current_time self.get_clock().now() elapsed (current_time - self.start_time).nanoseconds / 1e9 # 转换为秒 if self.state MOVE_FORWARD: # 发布向前移动指令 msg.linear.x self.side_length / self.duration_move msg.angular.z 0.0 self.publisher_.publish(msg) if elapsed self.duration_move: # 一边移动完成切换到旋转状态 self.state TURN self.start_time self.get_clock().now() self.side_count 1 self.get_logger().info(fFinished side {self.side_count}, turning...) elif self.state TURN: # 发布旋转指令 (90度) msg.linear.x 0.0 msg.angular.z 3.14159 / 2 / self.duration_turn # PI/2 弧度 / 时间 self.publisher_.publish(msg) if elapsed self.duration_turn: # 旋转完成判断是否画完正方形 if self.side_count 4: self.get_logger().info(Square drawing completed!) msg.linear.x 0.0 msg.angular.z 0.0 self.publisher_.publish(msg) self.timer.cancel() # 停止定时器 else: # 继续画下一条边 self.state MOVE_FORWARD self.start_time self.get_clock().now() def main(argsNone): rclpy.init(argsargs) node DrawSquareNode() rclpy.spin(node) rclpy.shutdown() if __name__ __main__: main()6.3 配置包文件为了让 ROS2 能找到我们的节点需要修改功能包的setup.py文件。打开~/turtle_ws/src/my_turtle_controller/setup.py找到entry_points部分修改为entry_points{ console_scripts: [ draw_square my_turtle_controller.draw_square:main, ], },6.4 编译与运行编译工作空间cd ~/turtle_ws colcon build --packages-select my_turtle_controller编译成功后记得 source 安装空间的环境source install/setup.bash运行测试在终端1确保turtlesim_node正在运行。在终端2运行我们刚写的节点ros2 run my_turtle_controller draw_square观察 turtlesim 窗口小海龟应该会自动开始画一个正方形并在完成后停止。效果验证如果小海龟能按预期画出闭合的正方形说明你的自定义节点成功创建、编译并通过话题通信正确控制了仿真器。这是你从 ROS2 用户迈向开发者的重要一步。7. 资源占用与性能观察turtlesim作为一个基础的图形化仿真工具资源占用极低几乎不会对系统造成负担。你可以在运行小海龟节点时打开系统监视器或使用top、htop命令查看。CPU 占用通常低于 1%。内存占用turtlesim_node进程内存占用通常在几十 MB 量级。网络负载由于是本地进程间通信使用 DDS/ROS2 中间件网络流量可忽略不计。性能瓶颈几乎不存在。这个实验的重点是验证通信机制的正确性而非性能测试。8. 常见问题与排查方法在实验过程中你可能会遇到一些问题。下表列出了常见问题及其解决方法。问题现象可能原因排查方式解决方案运行ros2命令提示“未找到命令”ROS2 环境变量未配置。执行echo $ROS_DISTRO若无输出则未配置。执行source /opt/ros/humble/setup.bash并确保已将其添加到~/.bashrc。启动turtlesim_node无窗口弹出可能缺少图形界面支持尤其在 SSH 或纯终端环境下。检查DISPLAY环境变量echo $DISPLAY。确保在图形界面下运行。对于 WSL2需要安装并运行 X Server如 VcXsrv。ros2 run turtlesim turtlesim_node报错提示找不到包turtlesim包未安装或环境未 source。运行apt list --installed | grep turtlesim。安装完整桌面版sudo apt install ros-humble-desktop。然后 source 环境。键盘控制节点 (turtle_teleop_key) 无响应终端焦点不对或节点未正确连接到turtlesim。1. 确保按键时终端窗口是激活状态。2. 分别用ros2 node list和ros2 topic list检查节点和话题是否存在。按正确顺序启动节点先turtlesim_node再turtle_teleop_key。确保在同一个 ROS2 网络域内。自定义节点编译失败Python 语法错误或setup.py配置错误。查看colcon build的错误输出信息。仔细检查 Python 代码缩进和语法。核对setup.py中entry_points的格式是否正确。自定义节点运行后海龟不动节点未成功发布消息或话题名/消息类型不匹配。1. 使用ros2 topic echo /turtle1/cmd_vel监听是否有消息。2. 使用ros2 node info /your_node_name检查节点发布的话题。检查代码中的话题名称 (/turtle1/cmd_vel) 和消息类型 (Twist) 是否完全正确。检查发布逻辑如定时器是否触发。服务调用失败服务名称或服务类型错误。使用ros2 service type service_name查看正确的服务类型。使用ros2 service list -t查看服务及其完整类型确保调用命令中的类型和字段结构正确。9. 最佳实践与使用建议基于小海龟实验可以延伸出一些良好的 ROS2 开发习惯每步一验证在编写复杂系统前像本实验一样先用命令行工具 (ros2 topic pub/list/echo,ros2 service call,ros2 param set/get) 手动测试通信链路是否通畅。这能快速定位是代码问题还是通信配置问题。善用ros2 node info这是理解任何未知节点最强大的命令能清晰列出其接口。工作空间管理为不同的项目创建独立的工作空间如~/robot_ws,~/simulation_ws并通过source相应的setup.bash来切换环境避免包冲突。版本控制将你的功能包代码src/目录下的内容纳入 Git 版本控制但忽略build/,install/,log/等编译生成目录。从仿真到实车小海龟验证了算法逻辑后下一步可以尝试在 Gazebo 中为真实的差分轮式机器人模型添加激光雷达、摄像头传感器并复用相同的/cmd_vel话题来控制它体验从仿真到实车的平滑过渡。深入学习方向掌握小海龟后可以探索自定义消息/服务接口定义自己的.msg和.srv文件。Launch 文件学习使用.launch.py文件一键启动多个节点。TF2 变换理解机器人坐标系间的变换。导航栈 (Nav2)这是 ROS2 中用于机器人自主导航的核心功能包集。小海龟实验是 ROS2 世界的“Hello, World!”。它用最直观的方式揭示了分布式机器人系统中节点如何通过话题、服务、参数进行通信与协作。成功完成这个实验意味着你已经打通了 ROS2 开发的任督二脉具备了探索更广阔机器人技术领域的基础能力。建议将本文中的命令和代码亲手运行一遍理解其背后的机制这远比阅读理论文档来得深刻。