ROS2 保姆级课程（Python 入门版）· 课程大纲

课程名称：ROS2 保姆级课程（Python入门版）
定位：面向零基础小白的 ROS2 保姆级入门视频课
形态：按集规划（每集含目标、演示、坑点、预期输出、小作业）
范围：环境 → 通信 → 工具链 → 建模仿真 → 综合项目
技术栈：WSL2 + Ubuntu 24.04 LTS · ROS2 Jazzy Jalisco（LTS）· Python 3.12 / rclpy · RViz2 · Gazebo Harmonic
GitHub：https://github.com/lddzwxy/ros2_crash_course_for_beginner_python

〇、全局约定（版本锁定）

一、课程定位

学完本课，我们能够独立完成：

1. 搭好 WSL2 + Ubuntu 24.04 + ROS2 Jazzy 环境，读懂并跑通任意入门级 ROS2 工程；
2. 熟练使用 Topic / Service / Action / Parameter；
3. 用 Python 3.12 + rclpy 写出可编译、可 launch、可调试的节点包；
4. 用 URDF/Xacro 描述差速小车，在 Gazebo Harmonic 跑起来并键盘遥控；
5. 看懂 TF、日志、bag、RQT，能排查"节点不说话 / 说话听不懂"；
6. 完成"仿真小车送货"综合项目，并看见 SLAM/Nav2 效果。

适合人群：零基础、算法验证、仿真开发、上位机逻辑、快速原型。

二、教学原则

每集标准结构

1. 目标（15s）　
2. 演示（30–60s）　
3. 讲解+跟做（主时长）　
4. 常见坑（1–2min）　
5. 预期输出（30s）　
6. 小作业+预告（30s）

单集时长：8–15 分钟（环境安装类 ≤ 20 分钟）。

三、课程地图

能力主线：环境与终端 → 节点/话题 → 服务与动作 → 启动组织 → 调试 → 坐标与模型 → 仿真 → 综合项目 → 看见进阶。

四、模块与分集大纲

模块 0 · 开机就绪：开发环境与 Linux 急救包（6 集）

目标：把"连 Ubuntu 都没装过"的人带到能流畅使用终端和 VS Code。
衔接：本模块不出现 ROS 概念。

小作业：~/dev/practice/ 下用 VS Code 写打印当前时间的脚本并跑通。
预期输出示例（0.2）：wsl -l -v 显示 Ubuntu-24.04 / VERSION 2；xeyes 弹窗。

模块 1 · ROS2 初印象：从安装到第一次编译（5 集）

衔接：依赖模块 0；结束时已有第一个 ROS2 包。

Jazzy 注意：文档停在 Jazzy 页；sudo apt install ros-jazzy-desktop python3-colcon-common-extensions python3-rosdep python3-vcstool。
小作业：包 my_first_pkg，节点打印 Hello ROS2，任意终端可 ros2 run。

模块 2 · 话题通信 Topic（6 集）

复用约定：此处 geometry_msgs/Twist 就是系列契约的 /cmd_vel，后续不改名。

小作业：一对节点发布/订阅 /turtle_cmd，ros2 topic hz 验证频率。

模块 3 · 服务、动作与自定义接口（6 集）

自定义接口放在手写 Server/Client 之前，解决"先用到再学"。

深度：3.2 讲清 package.xml depend 与 CMakeLists rosidl_generate_interfaces。
小作业：查询状态 Service + 前进 N 米 Action。

模块 4 · 参数、Launch、Lifecycle 与工程化（5 集）

小作业：launch 同时起 pub/sub，YAML 加载频率与话题名。

模块 5 · 可视化与调试工具（4 集）

小作业：录 bag 回放，rqt_plot 画曲线。

模块 6 · TF2 与机器人建模 URDF（6 集）

小作业：Xacro 双驱轮+支撑轮小车，RViz2 正确显示。

模块 7 · Gazebo Harmonic 仿真：让小车动起来（6 集）

控制路径：7.3 diff_drive 插件先跑通；7.5 了解 ros2_control；7.6 用插件路径验收。
只用 Harmonic + ros-jazzy-ros-gz*。

小作业：遥控绕障碍一圈，RViz2 看到激光与 TF。

模块 8 · 综合项目：仿真小车送货（5 集）

"货物"为概念设定，到达即送达。节点划分与话题契约对齐系列 CONTRACT.md，供 S2/S4 继续演进。

验收标准：

• 一条 launch 启动全系统；
• 可遥控，也可触发自动送货；
• RViz2 可见机器人、目标点、状态；
• README 含：WSL2 / Ubuntu 24.04 / Jazzy / Python 3.12 版本卡、启动方式、节点表、已知问题。

模块 9 · 体验进阶与路线图（2 集）

小作业：写 4 周自学计划（每周 3 个可完成目标）；用一句话说出 S2/S4 各解决什么。

五、贯穿项目与契约落点

本课结束时，工作空间 ros2_ws 中应有：

契约固定：/cmd_vel Twist、/odom Odometry、/scan LaserScan、map→odom→base_link、仿真 use_sim_time。S2 将用 C++ 实现同契约。

六、建议节奏与体量

七、配套仓库结构

ros2_ws/
├── README.md
├── 课程大纲.md                    # 总大纲（本文件）
├── 细纲/  
├── 讲义/      
└── code/                          # 可 colcon 编译的参考工作空间（Jazzy）
	├── CONTRACT.md                # 系列接口契约（cmd_vel/odom/scan/frames）
	├── README.md
	├── m0_setup/
	│   ├── check_env.sh           # 含 Ubuntu/Jazzy/Python/Gazebo 版本检查
	│   └── practice_python/
	└── src/
	    ├── my_first_pkg/
	    ├── my_topic_demo/
	    ├── my_interfaces/
	    ├── my_service_demo/
	    ├── my_action_demo/
	    ├── my_bringup/
	    ├── my_car_description/
	    ├── my_car_gazebo/
	    └── my_delivery/

八、全局避坑清单

九、验收清单（结课）

• wsl -l -v 为 VERSION 2；WSLg 可弹窗
• ros2 doctor 无致命错误；Python 3.12
• 能手写 pub/sub、service、action、自定义接口
• Launch + YAML 参数可启动多节点
• 会用 RQT / bag / logger 排查
• URDF 小车在 RViz2 与 Gazebo 中正确显示并可遥控
• 送货项目一条 launch 跑通，README 含版本卡
• 能说出 SLAM/Nav2 下一步学什么（进阶入口）

大纲版本：S1 v1.0 · 适用 ROS2 Jazzy Jalisco / Ubuntu 24.04 / Python 3.12