ROS2 核心通信：话题发布与订阅详解

在前两篇博客中，我们掌握了 ROS2 节点原理、功能包工程结构、C++节点编写、命令行启动与CMake编译 。从本篇开始，我们正式进入 ROS2 最核心的通信机制学习。

机器人系统本质是多节点协同通信 ：雷达节点发布数据、导航节点订阅数据、控制节点发布指令、底盘节点订阅指令。而支撑这一切的核心、ROS2 使用频率最高的通信方式，就是 话题通信（Topic）。

本文将从零讲解话题通信原理、适用场景、手把手实现完整 C++ 发布者与订阅者，最后重点讲解工业级话题通信最佳实践，帮你告别新手式乱写代码，养成规范开发习惯。

一、什么是 ROS2 话题通信？

1. 话题通信核心定义

话题（Topic） 是 ROS2 中异步、单向、发布/订阅模式的通信机制。

简单理解：

• 发布者（Publisher）：生产数据，主动向指定话题源源不断发送数据

• 订阅者（Subscriber）：监听话题，话题有数据就自动触发回调函数处理数据

• 话题 ：数据传输的"虚拟管道"，通过话题名称唯一标识

2. 核心特点（必考、面试常用）

• 异步通信：发布者只管发，订阅者只管收，双方互不阻塞，不需要等待对方响应

• 单向通信：数据只能从发布者流向订阅者，无法双向交互

• 多对多通信：一个话题可以多个发布者、多个订阅者，灵活适配多节点协作

• 松耦合 ：节点之间无需知道对方存在，只需要统一话题名 和消息类型即可通信

3. 适用场景

适合持续周期性传输数据的场景，是机器人数据流转的主体：

• 传感器数据：激光雷达、相机、IMU、里程计数据推送

• 状态数据：机器人位姿、速度、电量状态发布

• 控制指令：底盘速度指令、云台控制指令下发

4. 话题通信四要素

想要通信成功，四要素必须完全一致：

1. 话题名称（Topic Name）

2. 消息类型（Msg Type，如字符串、速度、位姿）

3. 通信协议匹配

4. 网络环境一致（本机/局域网）

二、准备工作：新建标准功能包

我们基于之前的工作空间，新建专属话题通信功能包，依赖 rclcpp（C++核心）、std_msgs（标准消息类型）。

cd ~/ros2_ws/src
ros2 pkg create --build-type ament_cmake --dependencies rclcpp std_msgs ros_topic_demo

进入功能包 src 目录，接下来编写发布、订阅节点源码。

三、C++ 实现话题发布者（Publisher）

1. 发布者源码 topic_pub.cpp

实现功能：循环发布字符串消息，1秒发布一次，打印发布日志。

#include "rclcpp/rclcpp.hpp"
#include "std_msgs/msg/string.hpp"

// 继承ROS2节点类
class TopicPublisher : public rclcpp::Node
{
public:
    // 构造函数：初始化节点、创建发布者、设置定时器
    TopicPublisher() : Node("topic_publisher_node")
    {
        // 创建发布者：话题名 /chatter，消息类型 String，队列长度10
        publisher_ = this->create_publisher<std_msgs::msg::String>("/chatter", 10);

        // 定时器：1000ms执行一次发布回调
        timer_ = this->create_wall_timer(
            std::chrono::milliseconds(1000),
            std::bind(&TopicPublisher::timer_callback, this)
        );
        RCLCPP_INFO(this->get_logger(), "话题发布者节点启动成功");
    }

private:
    // 定时器回调函数：执行消息发布
    void timer_callback()
    {
        // 1. 构造消息数据
        auto msg = std_msgs::msg::String();
        msg.data = "Hello ROS2 Topic! 话题通信测试";

        // 2. 发布消息
        publisher_->publish(msg);

        // 3. 打印日志
        RCLCPP_INFO(this->get_logger(), "发布消息: %s", msg.data.c_str());
    }

    // 发布者智能指针
    rclcpp::Publisher<std_msgs::msg::String>::SharedPtr publisher_;
    // 定时器智能指针
    rclcpp::TimerBase::SharedPtr timer_;
};

// 主函数入口
int main(int argc, char ** argv)
{
    rclcpp::init(argc, argv);
    auto node = std::make_shared<TopicPublisher>();
    rclcpp::spin(node); // 循环运行节点
    rclcpp::shutdown();
    return 0;
}

四、C++ 实现话题订阅者（Subscriber）

1. 订阅者源码 topic_sub.cpp

实现功能：监听 /chatter 话题，收到消息自动回调打印。

#include "rclcpp/rclcpp.hpp"
#include "std_msgs/msg/string.hpp"

class TopicSubscriber : public rclcpp::Node
{
public:
    TopicSubscriber() : Node("topic_subscriber_node")
    {
        // 创建订阅者：监听/chatter话题，队列10，绑定回调函数
        subscriber_ = this->create_subscription<std_msgs::msg::String>(
            "/chatter",
            10,
            std::bind(&TopicSubscriber::msg_callback, this, std::placeholders::_1)
        );
        RCLCPP_INFO(this->get_logger(), "话题订阅者节点启动成功");
    }

private:
    // 消息回调函数：收到消息自动执行
    void msg_callback(const std_msgs::msg::String::SharedPtr msg)
    {
        RCLCPP_INFO(this->get_logger(), "订阅消息: %s", msg->data.c_str());
    }

    // 订阅者智能指针
    rclcpp::Subscription<std_msgs::msg::String>::SharedPtr subscriber_;
};

int main(int argc, char ** argv)
{
    rclcpp::init(argc, argv);
    auto node = std::make_shared<TopicSubscriber>();
    rclcpp::spin(node);
    rclcpp::shutdown();
    return 0;
}

五、配置 CMakeLists.txt（核心必配）

必须手动添加编译规则，否则无法生成可执行文件，无法通过 ros2 run 启动。在文件末尾追加以下内容：

# 编译发布者节点
add_executable(topic_pub src/topic_pub.cpp)
ament_target_dependencies(topic_pub rclcpp std_msgs)

# 编译订阅者节点
add_executable(topic_sub src/topic_sub.cpp)
ament_target_dependencies(topic_sub rclcpp std_msgs)

# 安装可执行文件
install(TARGETS
  topic_pub
  topic_sub
  DESTINATION lib/${PROJECT_NAME}
)

六、编译与运行实操

1. 编译功能包

cd ~/ros2_ws
colcon build --packages-select ros_topic_demo
source install/setup.bash

2. 运行测试（多终端）

终端1：启动发布者

ros2 run ros_topic_demo topic_pub

终端2：启动订阅者

ros2 run ros_topic_demo topic_sub

此时可以看到，发布者持续发消息，订阅者实时接收消息，话题通信成功！

七、话题通信常用调试命令

开发调试必备，快速排查话题通信异常：

# 查看当前所有活跃话题
ros2 topic list

# 查看话题详细信息（消息类型、发布者/订阅者数量）
ros2 topic info /chatter

# 打印话题实时数据
ros2 topic echo /chatter

# 命令行手动发布话题数据（测试用）
ros2 topic pub /chatter std_msgs/msg/String "{data: 'test message'}"

# 查看话题发布频率
ros2 topic hz /chatter

八、ROS2 话题通信 工程级最佳实践（重点）

新手能跑通代码只是入门，想要适配工业项目、避免后期BUG、保证代码稳定性，必须遵守以下最佳实践。

1. 话题命名规范

• 统一使用小写+下划线命名，禁止大写、中文、空格

• 采用分层语义命名 ，区分设备与数据，例如：/lidar/point_cloud、/chassis/vel_cmd

• 全局话题加 /，局部私有话题不加 /

2. 消息类型选择原则

• 通用数据优先使用 ROS2 标准消息（std_msgs、sensor_msgs、geometry_msgs），兼容性最强

• 复杂自定义数据才使用自定义消息，避免过度封装

• 禁止乱用消息类型，速度指令统一用geometry_msgs/msg/Twist，传感器数据用对应专用消息

3. 队列长度（QoS）设置规范

• 新手默认写10，项目中需根据场景调整：高频传感器数据队列调大（50/100），低频指令队列保持10

• 正式开发禁止随意填写队列大小，队列过小会丢包，过大会占用内存

• 高精度实时场景，需配置 QoS 服务质量策略（可靠传输、实时传输）

4. 发布订阅开发规范

• 节点封装类化：所有节点必须继承 Node 类封装，禁止裸写main函数代码，结构清晰易维护

• 资源智能管理：统一使用 SharedPtr 智能指针，无需手动释放内存，避免内存泄漏

• 禁止阻塞回调：订阅回调函数内禁止写延时、死循环、耗时运算，否则阻塞整个节点通信

• 耗时算法单独开子线程处理，回调只做数据接收与缓存

5. 数据安全与异常处理

• 订阅消息必须做空指针判断，防止空数据崩溃：if(!msg) return;

• 高频发布数据避免频繁内存申请，可复用消息对象，提升运行效率

• 关键传感器数据增加超时判断，长时间无数据触发异常告警

6. 工程协作规范

• 所有项目话题名、消息类型统一文档记录，团队统一标准，避免通信不匹配

• 禁止随意修改正式话题名，改动需同步修改所有订阅、发布节点

• 多节点通信尽量模块化，一个节点只负责一类数据发布/订阅，符合单一职责原则

九、新手高频报错避坑

• 收发不到数据：话题名大小写不一致、消息类型不匹配、未source环境

• 编译报错找不到消息头文件：package.xml 未添加依赖、CMakeLists未绑定依赖

• 节点卡顿、数据延迟：回调函数内存在耗时操作、队列设置不合理

• 重复发布数据：定时器周期设置错误、多实例节点启动冲突

十、总结

话题通信是 ROS2 数据流的核心载体，几乎 90% 的机器人实时数据交互都基于话题实现。

通过本文你掌握了：

1. 话题通信的异步单向、多对多核心原理与适用场景

2. 完整可落地的 C++ 发布、订阅节点标准写法

3. 功能包配置、编译、运行全流程

4. 工业项目通用的话题通信最佳实践与避坑方案

后续的自定义消息、TF坐标变换、导航框架，全部依赖话题通信作为数据基础，熟练掌握本章内容，是进阶 ROS2 高级开发的必备前提。