简介：面向ROS学习者与机器人开发者的源码配套资源，汇集《ROS机器人开发实践》中的功能包，覆盖ros_primary基础功能、ros_advanced进阶内容，以及mrobot、marm机器人模型、感知与机器学习等模块，并包含需独立放置的ROS2功能包。资源共839个文件，以Python脚本、launch启动文件、XML/YAML配置、C++源码、URDF/xacro模型、RViz视图、proto及world仿真文件为主，另有PDF与笔记等参考文档，压缩包共146.12MB。已有1127人学习下载。通过源码包可对照书中案例搭建ROS工作空间，理解节点通信、参数服务器、导航与SLAM、多机器人协作等关键机制；mrobot与marm功能包便于验证移动机器人与机械臂控制逻辑，ROS2功能包则适合进阶体验新一代通信架构。整体目录按功能模块划分，便于按需检索与系统学习。

1. 环境准备：从零搭起ROS开发环境

1.1 为什么推荐用脚本安装ROS

不管你是照着《ROS机器人开发实践》这本书学，还是在网上看各种教程，第一步永远是装ROS。但这一步恰恰劝退了大量新手。ROS安装的痛点不在 apt install 本身，而在三个环节： 软件源、密钥更新、rosdep初始化 。这三个环节任何一个卡住，后续所有工作都停摆。

我第一次装ROS的时候，在 rosdep update 这一步耗了两天，翻遍论坛才找到是自己网络环境的问题。后来用了鱼香ROS的一键安装脚本，十分钟左右全部搞定。

提示：鱼香ROS一键安装脚本是目前国内ROS社区最常用的装环境工具，它会自动帮你处理软件源配置、密钥更新、rosdep初始化这些麻烦事，支持Ubuntu 18.04/20.04/22.04等主流版本，也能装ROS1和ROS2。用的时候注意认准官方发布渠道。

1.2 安装与验证的完整过程

这里我把基于《ROS机器人开发实践》这本书学习时的完整装环境流程记录下来，操作系统是Ubuntu 20.04：

# 使用鱼香ROS一键安装
wget http://fishros.com/install/onekey/install.sh
sudo bash install.sh

脚本运行后会弹出选择菜单，你按提示选“ROS1安装”，再选Ubuntu 20.04对应的ROS Noetic版本。等待脚本跑完，验证一下：

source /opt/ros/noetic/setup.bash
roscore

如果能正常看到 started core service [/rosout] ，说明ROS核心已经起来。紧接着开一个新终端，验证话题通信：

rosrun rospy_tutorials talker

再开一个终端：

rosrun rospy_tutorials listener

两个节点能互相收发数据，就说明整套环境完全可用。

装完ROS之后，还要创建用于编译《ROS机器人开发实践》源码的工作空间。我习惯放在 ~/catkin_ws/src ：

mkdir -p ~/catkin_ws/src
cd ~/catkin_ws/src
catkin_init_workspace
cd ~/catkin_ws
catkin_make
echo "source ~/catkin_ws/devel/setup.bash" >> ~/.bashrc
source ~/.bashrc

这一步做完，ROS环境搭建告一段落。接下来要面对的是源码本身。

2. 源码整体结构拆解

2.1 这本书源码的目录逻辑

《ROS机器人开发实践》的源码按照 章节 组织，每个章节对应一个或多个ROS功能包。拿到源码压缩包后，解压到工作空间的 src 目录下，先别急着编译，建议花几分钟通读目录结构。作者的代码风格总体上是规范清晰的，但存在几个需要注意的点：

• 部分功能包之间有 编译依赖关系 ，比如后面章节的代码依赖前面章节自定义的消息类型
• 有些包需要额外安装依赖库（比如 gazebo_ros_pkgs 、 navigation 、 gmapping ），缺了会编译报错
• 源码对应的ROS版本是 ROS Kinetic（Ubuntu 16.04） ，但你在Ubuntu 20.04上装的是Noetic，直接编译大概率会报错

2.2 从Kinetic迁移到Noetic的适配方法

这是所有拿这本书学习的人都要跨过的一道坎。Kinetic和Noetic之间，大部分API接口没有变化，但仍有少数不兼容的地方。我的做法是分三步走：

第一步，“无脑编译”看错误：

cd ~/catkin_ws
catkin_make

第二步，根据报错逐个修复。最常见的错误有两个：一是某些依赖包在Noetic里改名了（比如 ar_track_alvar 变成了 ar_track_alvar_msgs ，依赖关系要同步调整），二是Python相关的内容从Python 2迁到了Python 3（Kinetic默认Python 2，Noetic默认Python 3）。

具体到代码修改，最常见的是这个：

# Kinetic时代（Python 2）
import rospy
from std_msgs.msg import String

# Noetic下需要确保Python脚本的第一行是
#!/usr/bin/env python3

第三步，如果某些包编译不过且修复成本过高，直接 注释掉或排除 相关包，把能跑的代码先跑起来。比如硬件驱动相关的包，没有实体机器人根本用不上，跳过完全不影响学习核心概念。

注意：ROS学习本质上为什么、拆解底层的“理”远比跑通“代码”重要。因为底下的构建系统和通信机制在ROS 2上仍然相通，你今天啃下来的每一块骨头，到ROS 2时代都不会白费。

3. ROS基础功能核心解析

3.1 话题通信：ROS的“血管”

话题通信是ROS里最基础的通信方式，也是这本书前期例程的重头戏。它解决的是**“持续不断的消息流”**问题，比如传感器数据、里程计数据、图像数据。在这本书里，作者用发布者/订阅者的例子把话题通信讲得很透。

实际动手时，建议不要在例程代码上原地踏步，而是试着拆开看：

# 发布者核心代码
pub = rospy.Publisher('chatter', String, queue_size=10)
rate = rospy.Rate(10)  # 10 Hz
while not rospy.is_shutdown():
    pub.publish(data_str)
    rate.sleep()

queue_size 是很多新手容易忽略的参数。它定义的是发布者在未收到订阅者确认时，最多缓存多少条消息。设计上，队列满了之后， 新消息会覆盖旧消息 。在实时性要求高的场景（比如导航的 cmd_vel ），队列太长反而会让机器人执行延迟过高的指令。一般设置10左右够用，高频数据可以更小。

再看订阅者：

def callback(data):
    rospy.loginfo(data.data)

rospy.Subscriber('chatter', String, callback)

回调函数机制容易让人困惑——“为什么我的代码不会一路顺序执行下去？”。本质上， rospy.spin() 被调用后，ROS会进入事件循环，消息到达时自动触发回调函数。理解这一点，后面看机器人导航、SLAM的代码才不会一脸蒙。

3.2 服务通信：请求响应的“短对话”

话题通信适合持续的流式数据，而服务通信适合 一次性请求/响应 的场景。在这本书里，自定义服务类型的例程是个重点章节：

# 自定义srv文件
int64 a
int64 b
---
int64 sum

你需要在 CMakeLists.txt 和 package.xml 中配置编译依赖，然后通过 catkin_make 生成对应的Python/C++类。我自己第一次跑这个例程时，忘记在 package.xml 里加 message_generation 和 message_runtime 依赖，编译报了一大堆错误。

服务通信实际中用在哪里？举几个例子： /spawn 服务用于在Gazebo仿真中生成新物体， /map_server 服务用于加载地图，机器人端的“拍照”“打开机械臂夹爪”这类动作也适合做成服务。一句话记住区别： 话题是“一直说”，服务是“问一句答一句” 。

3.3 动作通信与参数服务器

书里后面还讲了动作通信（Action）。动作通信的定位，是处理 需要长时间执行、且能随时取消或反馈进度 的任务，比如导航到某个目标点。它比服务多了一个“反馈”通道——服务请求发出后你就干等结果，而动作通信可以实时回报“走到哪了”“还剩多少距离”。

参数服务器是另一个容易被忽略但非常实用的功能。你可以把它理解成ROS系统里的“全局配置中心”。比如导航时，代价地图的参数、局部路径规划器的参数，都存放在参数服务器上，运行过程中可以动态调整。

rosparam set /robot_name "turtlebot"
rosparam get /robot_name

和代码里直接写死参数相比，参数服务器的好处是改了参数不用重新编译代码。尤其是在调参阶段，节省的时间非常可观。

3.4 从ROS 1到ROS 2的思维转换

既然热搜词里有ROS 2，这里多说一句：你现在学的ROS 1知识，在ROS 2上大部分逻辑是通的，但有几处关键变化要提前知道。ROS 2把节点生命周期管理、DDS通信中间件、 launch 文件系统重构了一遍，Python代码里 rospy 变成了 rclpy ， rospy.Publisher 变成了 node.create_publisher ，而且不再需要 roscore 。

学习建议：把ROS 1作为理解概念的第一站，折腾完书上的仿真实验后，可以尝试用鱼香ROS一键安装再装一个ROS 2环境，把相同的话题通信例程用 rclpy 重写一遍。这个过程会加深你对“通信机制与代码实现分离”这一设计思想的理解。

4. 实操：建图、定位与路径规划仿真

4.1 让TurtleBot在Gazebo里动起来

书里最有价值的部分，是ROS机器人仿真的建图、定位、路径规划——这也是“ROS小车自主导航仿真”这个词背后大家真正关心的内容。你不需要实体机器人，在Gazebo仿真环境里就能跑完整个导航流程。

先启动仿真环境（以书里的TurtleBot为例）：

source ~/catkin_ws/devel/setup.bash
roslaunch turtlebot_gazebo turtlebot_world.launch

这一步会启动Gazebo和TurtleBot模型。第一次启动可能很慢，因为要加载模型和物理引擎，耐心等一两分钟。

然后是建图。这里有两条主流路线：

• gmapping ：基于激光雷达的2D SLAM，经典算法，计算量小，适合小场景
• cartographer ：Google出品，精度高，但对算力要求高，配置复杂

书里用的主要是 gmapping 。启动构图：

roslaunch turtlebot_gazebo gmapping_demo.launch

新开终端，用键盘控制机器人移动：

roslaunch turtlebot_teleop keyboard_teleop.launch

注意，键盘控制时机器人的移动速度不要过快，否则激光数据匹配容易出问题，建出来的地图会糊。我实测下来， 线速度0.2m/s，角速度0.5rad/s 是比较稳妥的设置。

4.2 自主导航的完整链路

地图构建完成后，用 map_server 保存：

rosrun map_server map_saver -f ~/map

这一步会生成 map.pgm （地图图片）和 map.yaml （地图配置）。需要注意 map.yaml 里的 resolution 和 origin 参数，后续加载导航时要保证一致。

导航分两点： 定位 和 路径规划 。

定位用的是AMCL（自适应蒙特卡洛定位）。简单理解：机器人不确定自己在哪，于是“撒”一堆粒子在地图上，不断根据激光数据跟地图匹配来收敛粒子。启动导航：

roslaunch turtlebot_navigation amcl_demo.launch map_file:=/home/yourname/map.yaml

然后用RViz打开， 先用“2D Pose Estimate”给机器人一个初始位姿 ，这个操作直接影响定位收敛速度。我见过不少新手跳过了这一步，结果导航一启动机器人就到处乱窜。

最后用“2D Nav Goal”在地图上指定目标点，ROS的全局路径规划器（ navfn 或 move_base 默认的 global_planner ）会算出一条从当前位置到目标点的最优路径，局部路径规划器（ base_local_planner 或 dwa_local_planner ）负责避开动态障碍。

4.3 三个仿真实验的避坑记录

跑仿真的过程中，最容易踩的坑有三个：

第一个是 Gazebo启动后画面全黑或模型不显示 ，多半是模型库下载不完整。可以检查 ~/.gazebo/models 文件夹里的文件数量，缺了什么就补什么。

第二个是 AMCL定位漂移严重 。多半是初始位姿给得不对，或者给出的位姿跟实际朝向相反。建议先观察RViz里激光雷达的数据，与地图轮廓对齐后再开始导航。

第三个是 路径规划频繁失败，报“No valid path” 。这个大概率是目标点设在了障碍物内部，或者地图栅格膨胀半径设得过大，导致机器人认为所有路径都被障碍物堵死。检查 costmap_common_params.yaml 里的 inflation_radius ，一般设0.3到0.5米比较合适。

5. 编译与运行常见问题排查

5.1 依赖缺失与版本冲突

《ROS机器人开发实践》源码在Ubuntu 20.04 + Noetic环境下，最常见的编译错误是找不到某些依赖包。这里分享我的排查方法：

# 第一步：根据报错信息反查问题包
# 例如报错 “Could not find a package configuration file provided by 'XXX'”
sudo apt search ros-noetic-XXX

如果软件源里没有这个包，一般有两个原因：一是这个包属于特定发行版，需要从源码编译；二是包名在Noetic中变了。前者可以直接把源码clone到 src 目录重新编译，后者需要你改 package.xml 里的依赖名。

5.2 launch文件启动失败的快速定位

roslaunch 报错时，不要只盯着最后几行红色文字。 launch 文件解析失败的原因往往是XML格式问题，可以用这个命令快速检查：

xmllint your.launch

如果是节点启动后立即退出，先手动运行对应节点，看终端上的直接输出：

rosrun package_name node_name

这会跳过 launch 文件那一层，让你看清节点本身到底报了什么错。

5.3 常见错误速查表

错误现象	可能原因	排查与解决
roscore 启动失败，端口被占用	上一次运行未正常退出	killall -9 roscore rosmaster 后重试
catkin_make 报 Could not find a package configuration file	缺少依赖包	sudo apt install ros-noetic-<包名>
Python脚本运行报 No module named rospy	环境变量未加载	检查 .bashrc 是否source了 setup.bash
roslaunch 找不到功能包	包未编译或工作空间未source	catkin_make 后重新 source devel/setup.bash
Gazebo加载模型时卡死	模型库下载不完整	检查 ~/.gazebo/models ，补全模型文件
键盘控制无响应	终端焦点不正确	确保光标在键盘控制终端内，且窗口未被遮挡
地图保存后是黑图	map_saver 执行时没有地图数据	确认建图节点还在运行，且收到激光数据

5.4 环境变量的坑与“一劳永逸”的配置

最后提一个很多人都会忽略的细节： .bashrc 里的source顺序。

我见过一种情况——用户安装了多个版本的ROS，或者同时source了ROS 1和ROS 2的环境。结果终端一打开，环境变量相互污染， roscore 能用但 rosrun 找不到包，或者 Python 导入 rospy 失败，极其玄学。

如果你遇到类似问题，先执行：

echo $ROS_DISTRO
echo $ROS_PACKAGE_PATH

看看是不是预期的路径。如果不对，检查 .bashrc 里的source行，把不需要的source注释掉，确保只保留一个ROS发行版的环境。否则每次调试都在跟环境变量较劲，真的会让人怀疑人生。

写在实际操作之后

我读《ROS机器人开发实践》源码时踩过的坑，比书里代码行数还多。现在回头看，那些坑基本都是“环境问题”与“概念不理解”的混合体。环境问题，靠鱼香ROS一键安装和反复重装解决了；概念不理解，靠把代码每一行拆开重写一遍解决了。

如果你也在学这本书，我建议你拿到源码后，先不要急着 catkin_make 。花一个小时把目录结构摸清楚，把话题通信、服务通信的例程代码一行行读明白，再动手编译。有些包编译不过就先跳过，先把核心功能玩起来。ROS学习的核心不是跑通代码，而是搞清楚数据在哪里、怎么流动、经过哪些处理——这些想明白了，换个机器人平台、换个ROS版本，你照样能上手。

本文还有配套的精品资源，点击获取