🚀 ROS2 入门实战:跑通你的第一个节点

1 认识 ROS:一个生动的比喻

想象要造一个机器人,它需要:眼睛(摄像头/激光雷达)、大脑(决策电脑)、四肢(轮子/机械臂)、神经系统(线路与信号)。从零开始的话,换一个摄像头、加一个机械臂,整个通信系统可能都要重写。

2 核心概念:一张"人体类比"表

3 ROS1 vs ROS2:先学会"判别",再谈学习

网上海量教程仍是 ROS1 的,学习前先分清版本,否则会卡在各种报错里。

4 安装与环境:小鱼一键安装 + 环境变量

国内用户强烈推荐 小鱼的一键安装脚本(支持 ROS Noetic / ROS2 Foxy / Humble 等):

wget http://fishros.com/install -O fishros && . fishros

安装后检查环境变量是否已写入 ~/.bashrc(或 ~/.zshrc):

source /opt/ros/humble/setup.bash   # ROS2 Humble(Ubuntu 22.04)
source ~/ros2_ws/install/setup.bash  # 你的工作空间(见下,别写进 .bashrc!)

验证:printenv | grep ROS 或直接敲 ros2 看是否有帮助信息。

5 终端优化:Zsh + Oh My Zsh(回报率极高)

ROS 命令又长又多,配一个强大的命令行环境非常值得。三步搞定:

git clone https://github.com/zsh-users/zsh-autosuggestions.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting
# 编辑 ~/.zshrc,把 plugins=(git) 改为:
plugins=(git zsh-autosuggestions zsh-syntax-highlighting)
# 然后:
source ~/.zshrc   # 或 exec zsh

验证:新终端输入 ros2 topic list - 后按 Tab,应能看到参数补全提示。

6 实战:从零跑通第一个发布者节点

6.1 创建工作空间

mkdir -p ~/ros2_ws/src
cd ~/ros2_ws

src 是源代码目录(关键字);功能包都放这里。

6.2 创建功能包

cd ~/ros2_ws/src
ros2 pkg create --build-type ament_python --node-name simple_publisher my_first_package

--build-type ament_python 指定 Python 包(C++ 用 ament_cmake);--node-name 自动生成节点文件。生成的结构:

src/my_first_package/
├── my_first_package/
│   ├── __init__.py
│   └── simple_publisher.py   <- 节点代码在这
├── package.xml               <- 包清单(依赖/许可证)
├── setup.cfg
├── setup.py                  <- 入口点配置(见 6.4)
└── resource/

6.3 编写发布者代码

用编辑器打开 simple_publisher.py,替换为:

import rclpy
from rclpy.node import Node
from std_msgs.msg import String

class MinimalPublisher(Node):
    def __init__(self):
        super().__init__('minimal_publisher')
        # 创建发布者:向 talker_topic 发 String 消息,队列长度 10(QoS 基础)
        self.publisher_ = self.create_publisher(String, 'talker_topic', 10)
        # 定时器:每 0.5 秒触发一次
        self.timer = self.create_timer(0.5, 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(args=None):
    rclpy.init(args=args)
    minimal_publisher = MinimalPublisher()
    rclpy.spin(minimal_publisher)   # 保持运行,处理回调
    minimal_publisher.destroy_node()
    rclpy.shutdown()

if __name__ == '__main__':
    main()

6.4 配置 setup.py 入口点

entry_points={
    'console_scripts': [
        'talker = my_first_package.simple_publisher:main',
    ],
},

意思是:创建名为 talker 的可执行脚本,运行它即执行包内模块的 main()。

6.5 编译 → 激活 → 运行 → 验证

# ① 编译(在 ~/ros2_ws)
cd ~/ros2_ws
colcon build

# ② 激活环境(每个新终端都要先 source!)
source install/setup.bash

# ③ 运行节点(同一个已激活的终端)
ros2 run my_first_package talker
#    → [INFO] Publishing: "Hello World: 0" ... 每秒刷屏

# ④ 新开一个终端,先 source,然后验证:
source ~/ros2_ws/install/setup.bash
ros2 topic list          # 应看到 /talker_topic
ros2 topic echo /talker_topic   # 实时看到发布的消息
rqt_graph                # 可视化计算图:节点 → 话题

7 命令行速查表(调试必备)

8 本节自测

9 参考来源

• 西安交通大学笃行机器人队 · ROS2教程(本页主要参考)
• ROS2 官方教程(Tutorials)
• 小鱼 ROS 一键安装
• Oh My Zsh 官网
• 本站 04-03 · ROS2 与机器人软件栈(概念详解)