第2天 ROS 《ROS文件系统+常用命令实战（小乌龟案例）零基础吃透》

📌 博客前言

✅ 配套实验环境：ROS Noetic（Ubuntu20.04） | Melodic、Kinetic版本命令、逻辑完全通用

一、本节课教学目标

1. 理解ROS工作空间（Workspace）概念、目录结构与实际开发用途

2. 掌握ROS功能包（Package）创建规则、标准目录组织方式

3. 熟记ROS系统高频命令，熟练查看节点、话题、服务、参数信息

4. 完成小乌龟综合实验，闭环：工作空间→功能包→代码→编译→运行全套开发流程

二、核心概念精讲（课堂原话）

2.1 ROS工作空间（Workspace）

1. 核心概念

工作空间是ROS项目的顶层根目录，统一托管全部功能包、编译缓存、环境变量、项目依赖；所有ROS自定义代码、驱动、URDF模型都必须放在工作空间内，才能正常编译运行。

2. 标准目录结构（catkin_ws标准架构）

catkin_ws/
├─ src/        # 【核心目录】存放所有自定义功能包、源码文件
├─ build/      # 编译临时目录，存放编译中间文件、cmake缓存
├─ devel/      # 开发运行目录，存放可执行程序、环境配置脚本
└─ install/    # 可选安装目录，初学开发全程无需使用

3. 工作空间基础操作命令

（1）从零创建工作空间

# 递归创建工作空间+src源码目录
mkdir -p ~/catkin_ws/src
# 切换至工作空间根目录
cd ~/catkin_ws
# 初始化编译环境，自动生成build、devel文件夹
catkin_make

（2）激活工作空间环境

# 激活当前终端工作空间环境
source devel/setup.bash

🔥 课堂高频考点：source devel/setup.bash 作用

让当前终端识别当前工作空间内：自定义功能包、Python节点、launch文件、自定义消息/服务。

不执行该命令：执行rosrun直接报错 —— package not found

✅ 永久配置环境（一劳永逸）：

echo "source ~/catkin_ws/devel/setup.bash" >> ~/.bashrc source ~/.bashrc

2.2 ROS功能包（Package）

功能包是ROS开发最小功能单元，节点代码、URDF模型、启动文件、自定义消息、依赖配置全部封装在功能包内部，是ROS开发最小载体。

1. 功能包创建语法+实操

语法：catkin_create_pkg 包名 依赖1 依赖2 ...

# 必须进入src源码目录创建！！
cd ~/catkin_ws/src
# 创建turtle_test功能包，绑定三大核心依赖
catkin_create_pkg turtle_test rospy std_msgs geometry_msgs

2. 功能包标准目录结构

my_package/
├─ CMakeLists.txt      # 编译配置文件（C++必改，Python零基础无需修改）
├─ package.xml         # 包描述文件、依赖声明核心文件
├─ scripts/            # 规范存放Python脚本节点
├─ src/                # 存放C++源码文件
├─ msg/                # 自定义消息文件目录
└─ srv/                # 自定义服务文件目录

3. 开发硬性注意事项

1. CMakeLists.txt + package.xml 功能包生死文件，禁止删除、重命名

2. Python脚本放入scripts文件夹后，必须授权：chmod +x 脚本名.py

3. 功能包名称：禁止大写字母、中文、特殊符号、空格

2.3 核心编译命令：catkin_make

1. 一句话作用

编译整个ROS工作空间，批量解析所有功能包依赖、编译源代码、生成可执行程序与环境脚本；等同于C语言gcc编译代码。

2. 底层执行流程

1. 扫描src目录下全部自定义功能包

2. 读取package.xml，解析全部依赖关系

3. 读取CMakeLists.txt，匹配编译规则

4. 编译源码，生成可运行节点程序

5. 自动生成build、devel两大编译目录

3. ROS开发黄金三连命令（必背）

cd ~/catkin_ws       # 切入工作空间根目录
catkin_make          # 全局编译工作空间
source devel/setup.bash  # 激活环境变量

🥳 课堂趣味比喻（方便学生记忆）

• src文件夹 = 厨房（源代码 = 食材）

• catkin_make = 开火做饭（编译源码）

• devel文件夹 = 成品饭菜（编译完成程序）

• source激活命令 = 饭菜上桌（终端识别程序）

• rosrun运行节点 = 开饭执行程序

三、ROS全套常用命令汇总（期末速查表）

ROS所有命令围绕五大核心：节点Node、话题Topic、服务Service、参数Param、功能包Package

✅ 零基础记忆口诀

roscore 启系统，rosrun 跑节点

rosnode 看节点，rostopic 看通信

rosmsg 看格式，rosservice 调功能

rosparam 改参数，rqt_graph 看关系

四、综合实战：让小乌龟转起来（课堂完整版实验）

实验目标

1. 闭环工作空间+功能包完整开发流程

2. 实操全部ROS命令，吃透节点/话题/服务/参数四大通信逻辑

实验前置准备

一次性打开4个终端，所有终端统一加载基础环境

source /opt/ros/noetic/setup.bash
# 配置永久环境后下方命令可省略
source ~/catkin_ws/devel/setup.bash

步骤1：搭建项目环境

# 1. 创建并初始化工作空间
mkdir -p ~/catkin_ws/src
cd ~/catkin_ws
catkin_make
source devel/setup.bash

# 2. 创建实验功能包
cd ~/catkin_ws/src
catkin_create_pkg turtle_test rospy std_msgs geometry_msgs

步骤2：编写Python小乌龟控制节点

# 切入功能包、创建脚本文件夹
cd ~/catkin_ws/src/turtle_test
mkdir scripts && cd scripts
vim move_turtle.py

Python源码直接复制：

#!/usr/bin/env python3
import rospy
from geometry_msgs.msg import Twist

# 初始化ROS节点
rospy.init_node('move_turtle')
# 绑定小乌龟速度话题
pub = rospy.Publisher('/turtle1/cmd_vel', Twist, queue_size=10)
# 设置程序运行频率
rate = rospy.Rate(10)

# 配置运动速度：前进+旋转画圆
msg = Twist()
msg.linear.x = 1.0    # X轴线速度 前进
msg.angular.z = 0.5   # Z轴角速度 旋转

# 循环发布速度指令
while not rospy.is_shutdown():
    pub.publish(msg)
    rate.sleep()

⚠️ 必执行：添加脚本执行权限

chmod +x move_turtle.py

步骤3：全局编译+激活环境

cd ~/catkin_ws
catkin_make
source devel/setup.bash

步骤4：四终端分工启动项目

终端1：启动ROS核心服务

roscore

终端2：启动小乌龟仿真窗口

rosrun turtlesim turtlesim_node

终端3：运行自定义控制脚本

rosrun turtle_test move_turtle.py

✅ 现象：小乌龟自动持续画圆运动

终端4：全部命令实操训练

1、节点查看命令

rosnode list
rosnode info /turtlesim

2、话题查看命令

rostopic list
rostopic info /turtle1/cmd_vel
rosmsg show geometry_msgs/Twist

3、终端手动控龟（不用代码）

# 匀速直行
rostopic pub -r 10 /turtle1/cmd_vel geometry_msgs/Twist "linear: {x: 2.0}, angular: {z: 0.0}"
# 原地旋转
rostopic pub -r 10 /turtle1/cmd_vel geometry_msgs/Twist "linear: {x: 0.0}, angular: {z: 1.0}"

4、获取乌龟实时坐标姿态

rostopic echo /turtle1/pose
rostopic hz /turtle1/pose

5、服务调用：新增/删除乌龟

# 生成第二只乌龟
rosservice call /spawn "x: 2.0,y: 2.0,theta: 0.0,name: 'turtle2'"
# 清空运动轨迹
rosservice call /clear
# 重置仿真窗口
rosservice call /reset

6、参数修改：更改画布背景色

rosparam set /turtlesim/background_r 255
rosparam set /turtlesim/background_g 255
rosparam set /turtlesim/background_b 255
rosservice call /clear

7、可视化通信拓扑图

rqt_graph

五、课堂标准演示流程（授课直接照搬）

1. roscore 启动ROS核心

2. rosrun turtlesim turtlesim_node 启动小乌龟仿真

3. rosnode list / rosnode info 排查节点信息

4. rostopic系列 查看话题通信机制

5. rostopic pub 手动下发运动指令

6. rosservice 调用服务新增乌龟、清屏

7. rosparam 修改全局画布参数

8. rqt_graph 图形化复盘通信逻辑

六、课程核心总结

1. 工作空间：项目顶层目录，src存包、catkin_make编译、source激活环境

2. 功能包：ROS最小功能模块，双配置文件缺一不可，Python脚本必须授权

3. 四大核心通信：节点=程序、话题=持续通信、服务=单次交互、参数=全局配置

4. 固定开发流水线：建工作空间→建功能包→写代码→编译→激活环境→启动节点

七、新手高频报错解决方案

1. 报错：package not found：执行source devel/setup.bash激活环境

2. 报错：Python脚本无法启动：执行chmod +x 授权脚本权限

3. 报错：roscore端口占用：重启终端、关闭残留ROS进程即可

CSDN博客标签：

#ROS入门 #ROS零基础 #ROS命令 #turtlesim仿真 #机器人开发 #Ubuntu运维 #ROS教案

专栏更新：持续更新ROS全套课堂教案、小车URDF建模、底盘驱动、SLAM建图全套课程，一键订阅不迷路✅