简介这份资源是《ROS机器人开发实践》一书的配套源码包面向正在学习ROS机器人操作系统的高校学生、科研人员与工程开发者帮助读者在真实代码环境中理解书中从基础到进阶的完整知识体系。压缩包共839个文件约146.12MB以222个Python脚本、87个launch启动文件、27个C源文件及大量xml、yaml、xacro配置为主另含rviz可视化配置、world仿真场景与urdf/srdf模型描述覆盖节点通信、话题与服务调用、参数服务器、导航定位、SLAM建图及多机器人协同等典型场景。资源按ros_primary、ros_advanced、robot_mrobot、robot_marm、robot_perception、robot_learning与ros2等模块组织其中ROS2功能包需独立于ROS1工作空间运行避免环境冲突。目前已有1137人学习下载读者可借助这些可运行示例快速搭建实验环境、对照调试并掌握功能包创建与管理方法为机器人系统设计与开发打下扎实基础。1. 从一堆散装节点到能跑通建图这套 ROS 源码到底值不值得拆很多人第一次接触机器人开发卡住的地方不是算法而是环境。你装好了 ROS敲了roscore终端里滚出一堆日志然后呢不知道下一步该干嘛。手里没有一套能直接跑通的代码光看文档里的概念永远停在“知道有这个话题”的阶段。这套《ROS机器人开发实践》配套源码里的 ROS 基础功能部分解决的就是这个断层——它把话题通信、服务、参数服务器、TF 变换、URDF 建模、Gazebo 仿真、SLAM 建图这些环节全部落成了可执行的包和 launch 文件。适合谁刚学完 ROS 基础语法、想找个完整工程练手的人也适合工作里要快速搭原型验证想法的工程师。我拆完的感受是它不炫技但骨架完整能让你把“机器人开发”这四个字从抽象概念变成终端里跑起来的东西。2. 环境搭建与工作空间初始化别让版本问题吃掉你两天2.1 选 ROS1 还是 ROS2先看源码依赖这套源码的 ROS 基础功能部分主体是按 ROS1 的 catkin 构建体系组织的。如果你机器上装的是 ROS2直接拿来编译会报一堆find_package(catkin REQUIRED)找不到包的错。常见做法是确认你的系统版本和 ROS 发行版对应关系比如 Ubuntu 20.04 对应 Noetic18.04 对应 Melodic。我一般会先跑一条命令确认当前环境# 查看已安装的 ROS 发行版 printenv | grep ROS # 输出示例 # ROS_DISTROnoetic # ROS_VERSION1如果ROS_VERSION显示 2那这套源码里的package.xml格式和 CMakeLists 写法都需要改工作量不小。新手建议直接找一台能装 ROS1 的机器或容器别硬扛版本迁移。确认版本后安装基础依赖# 安装 catkin 构建工具和常用依赖 sudo apt update sudo apt install -y python3-catkin-tools python3-rosdep python3-rosinstall-generator # 初始化 rosdep只跑一次 sudo rosdep init rosdep updaterosdep的作用是自动解析package.xml里声明的系统依赖比如roscpp、tf、gazebo_ros这些。不初始化它后面rosdep install会直接报错。这一步的坑在于网络环境如果rosdep update卡住可以换时间段重试或者手动配置源但别去碰那些来路不明的镜像脚本。2.2 创建工作空间并编译源码假设你已经把源码包放到了~/ros_ws/src下面。标准流程是# 进入工作空间根目录 cd ~/ros_ws # 用 catkin_make 编译-j2 表示用两个线程内存小的机器别开太多 catkin_make -j2 # 编译完成后 source 环境 source devel/setup.bash编译过程中最常见的报错是缺包。比如提示Could not find a package configuration file provided by gazebo_ros说明 Gazebo 相关的 ROS 包没装。用rosdep补# 在工作空间根目录执行自动安装 package.xml 里缺失的依赖 rosdep install --from-paths src --ignore-src -r -y--from-paths src指定扫描源码目录--ignore-src表示不重新安装源码里已有的包-r是遇到错误继续-y是自动确认。跑完再catkin_make一次大部分依赖问题就清了。编译通过后source devel/setup.bash这步不能省否则rosrun找不到你刚编出来的节点。我习惯把它写进~/.bashrc但注意如果你有多个工作空间后 source 的会覆盖前面的得用source ~/ros_ws/devel/setup.bash --extend来叠加。3. 话题、服务与参数把通信机制跑通再谈算法3.1 用 launch 文件一次性拉起多个节点源码里很多功能不是单个节点能演示的比如一个发布者加一个订阅者手动开两个终端rosrun很麻烦。launch 文件就是干这个的。一个典型的启动文件结构launch !-- 启动发布者节点节点名重映射为 talker -- node pkgmy_ros_basics typepublisher_node nametalker outputscreen/ !-- 启动订阅者节点订阅的话题重映射到 /chatter -- node pkgmy_ros_basics typesubscriber_node namelistener outputscreen remap frominput_topic to/chatter/ /node !-- 加载参数文件到参数服务器 -- rosparam file$(find my_ros_basics)/config/params.yaml commandload/ /launchoutputscreen让节点日志直接打到当前终端调试时必加。remap是话题重映射把节点内部写死的input_topic换成实际通信的/chatter。rosparam那行把 YAML 文件里的参数批量塞进参数服务器节点里用ros::param::get就能读到。启动方式roslaunch my_ros_basics demo.launch如果报RLException: [demo.launch] is neither a launch file in package...说明包路径没被 ROS 找到。先确认rospack find my_ros_basics能返回路径返回空就重新source devel/setup.bash。3.2 服务通信的同步调用与超时处理话题是异步的服务是同步的。源码里有个典型的加法服务示例客户端发两个数服务端返回和。服务端定义// 服务回调函数req 是请求res 是响应 bool addCallback(my_ros_basics::AddTwoInts::Request req, my_ros_basics::AddTwoInts::Response res) { res.sum req.a req.b; ROS_INFO(request: x%ld, y%ld, (long int)req.a, (long int)req.b); ROS_INFO(sending back response: [%ld], (long int)res.sum); return true; }客户端调用时新手最容易忽略超时。如果服务端没起来ros::service::call会一直阻塞。稳妥写法是// 等待服务可用最多等 5 秒 if (!ros::service::waitForService(add_two_ints, ros::Duration(5.0))) { ROS_ERROR(Service not available after 5 seconds); return 1; } my_ros_basics::AddTwoInts srv; srv.request.a 10; srv.request.b 20; if (client.call(srv)) { ROS_INFO(Sum: %ld, (long int)srv.response.sum); } else { ROS_ERROR(Failed to call service); }waitForService的第二个参数是超时时间不写就无限等。client.call返回 false 通常意味着服务端中途挂了或者网络断了。参数服务器那块注意rosparam加载的 YAML 里数字会被解析成 int 或 double但 C 里getParam时类型不匹配会抛异常用ros::param::paramint(~my_param, default_value)这种带默认值的写法更安全。4. TF 变换与 URDF 建模机器人为什么会在 RViz 里“飘”4.1 TF 树的父子坐标系关系TF 是 ROS 里最让人头大的部分之一但它的逻辑其实很直白任何时刻机器人上每个部件的位置都要能通过一棵树追溯到根坐标系。源码里常见的 TF 广播代码// 创建一个 TransformBroadcaster static tf::TransformBroadcaster br; tf::Transform transform; // 设置平移单位是米 transform.setOrigin(tf::Vector3(1.0, 0.0, 0.5)); // 设置旋转用四元数表示 tf::Quaternion q; q.setRPY(0, 0, M_PI / 4); // 绕 Z 轴转 45 度 transform.setRotation(q); // 广播从 world 到 base_link 的变换 br.sendTransform(tf::StampedTransform(transform, ros::Time::now(), world, base_link));sendTransform的参数顺序是变换本身、时间戳、父坐标系、子坐标系。时间戳用ros::Time::now()如果用了仿真时间得确保/clock话题在发布否则 TF 会报Lookup would require extrapolation into the future。这个报错的意思是你查询某个时刻的变换但 TF 缓存里没有那个时间点的数据。常见原因是广播频率太低或者查询的时间戳比最新数据还新。解决方法是把广播放在一个高频循环里比如 50Hz并且查询时用ros::Time(0)表示“最新可用”。4.2 URDF 文件里的惯性矩阵与碰撞体URDF 描述机器人模型源码里的示例通常包含 base_link、轮子、激光雷达等。一个轮子的 URDF 片段link nameleft_wheel visual geometry cylinder radius0.05 length0.03/ /geometry /visual collision geometry cylinder radius0.05 length0.03/ /geometry /collision inertial mass value0.5/ inertia ixx0.0001 ixy0 ixz0 iyy0.0001 iyz0 izz0.0002/ /inertial /linkvisual是显示用的collision是物理碰撞用的inertial是动力学仿真用的。新手常犯的错是只写visual不写collision和inertial结果 Gazebo 里模型直接穿地或者飞走。惯性矩阵不能随便填圆柱体的转动惯量有公式填错了仿真会抖得厉害。如果不想手算可以用 SolidWorks 插件导出或者用xacro宏来参数化生成。检查 URDF 是否合法# 把 xacro 转成 urdf 并检查 rosrun xacro xacro model.xacro model.urdf check_urdf model.urdfcheck_urdf会输出树形结构如果某个 link 没有父节点会明确告诉你。RViz 里模型“飘”或者“散架”九成是 TF 没接上或者 URDF 里 link 的 origin 写错了。5. 避坑与排查那些让我重启终端到怀疑人生的瞬间5.1 现象roslaunch启动后 Gazebo 黑屏或模型下坠原因Gazebo 的物理引擎需要inertial参数缺失时质量默认为零模型会被重力瞬间拉走。另外如果world文件里没加地面模型也会一直掉。解决检查 URDF 里每个 link 是否都有inertial质量给一个合理值轮子 0.1~0.5kg底盘 1~5kg。在 launch 里加载一个带地面的 world 文件include file$(find gazebo_ros)/launch/empty_world.launch arg nameworld_name value$(find my_ros_basics)/worlds/ground.world/ /include5.2 现象RViz 里激光雷达数据不显示Fixed Frame 报错原因RViz 的 Fixed Frame 默认是map但你的 TF 树里可能只有odom和base_link没有map。解决把 Fixed Frame 改成odom或base_link或者在 launch 里启动一个static_transform_publisher把map和odom连起来。命令示例rosrun tf static_transform_publisher 0 0 0 0 0 0 map odom 100最后那个100是发布频率毫秒表示每 100ms 发一次。5.3 现象catkin_make报No such file or directory: python3原因有些旧版 ROS 包在 CMakeLists 里写死了python但系统只有python3。解决装一个兼容包sudo apt install python-is-python3或者在 CMakeLists 里把find_package(PythonInterp)改成find_package(Python3 COMPONENTS Interpreter)。我一般优先改 CMakeLists避免全局改动影响其他工具。5.4 现象SLAM 建图时地图重叠、墙壁重影原因里程计漂移太大或者激光雷达的安装位置在 TF 里写错了。解决先检查base_link到laser的 TF 变换用rosrun tf tf_echo base_link laser看平移和旋转是否和实际安装一致。如果里程计漂移可以调低gmapping的linearUpdate和angularUpdate参数让机器人走更短距离就更新一次地图。源码里的slam.launch通常有这些参数改小一点试试。6. 从仿真到真机用 rosbag 做离线复现与参数调优仿真跑通之后下一步是把数据录下来反复回放这比每次重新启动 Gazebo 高效得多。rosbag是 ROS 里的黑匣子能把话题数据完整存下来。录制所有话题# 录制所有话题到当前目录的 all_topics.bag rosbag record -a # 只录制激光和里程计-O 指定输出文件名 rosbag record -O scan_odom.bag /scan /odom回放时注意时间同步问题。如果回放的是仿真数据而你的节点用了ros::Time::now()时间会对不上。正确做法是回放时加--clock参数并让节点使用仿真时间# 回放 bag 并发布 /clock rosbag play --clock scan_odom.bag同时在 launch 里设置param name/use_sim_time valuetrue/这样节点里的ros::Time::now()就会跟随 bag 里的时间戳TF 查询也不会报 extrapolation 错误。我习惯在调 SLAM 参数时先录一段 2 分钟的 bag然后反复回放每次只改一个参数比如gmapping的particles从 30 改到 50看地图闭合效果。这样比在仿真里来回跑省时间也更容易复现问题。从那以后我每次调参都强制先录 bag不然改了什么、效果怎么变的根本说不清。希望这套源码和这些踩坑记录能帮你少走点弯路。本文还有配套的精品资源点击获取