WSL2 安装 ROS2 全流程与踩坑总结(Ubuntu 22.04 + ROS 2 Humble)
WSL2 安装 ROS2 全流程与踩坑总结(Ubuntu 22.04 + ROS 2 Humble)
一、背景
在 Windows 环境下进行机器人开发时,直接安装 Linux 双系统成本较高,因此选择:
- Windows + WSL2 + Ubuntu 22.04
- 安装 ROS 2 Humble 作为开发环境
目标是:搭建一个可用于机器人算法开发与仿真的基础环境。
二、环境搭建流程
1. WSL2 + Ubuntu 安装
确保:
1 | |
安装 Ubuntu 22.04,并完成基础初始化。
2. 系统更新与基础配置
1 | |
3. 添加 ROS2 软件源
1 | |
1 | |
1 | |
4. 安装 ROS2
1 | |
5. 配置环境变量
1 | |
6. 测试 ROS2
打开两个终端:
1 | |
三、核心问题与踩坑总结
❗问题1:listener 无输出(节点通信失败)
表现:
- talker 正常输出
- listener 无任何响应
🔍 原因分析
ROS2 使用 DDS(数据分发服务)进行节点通信:
- 节点之间通过网络发现彼此
- WSL2 默认网络对多播(multicast)支持不完整
导致节点“互相看不到”。
✅ 解决方案
- 开启 WSL 镜像网络模式:
1 | |
- 但该方法不完全可靠。
❗问题2:DDS 实现不稳定
默认使用 Fast DDS,在 WSL2 下容易出现:
- 节点发现失败
- topic 不同步
✅ 解决方案(关键)
切换为更稳定的实现:
1 | |
1 | |
本质上是更换 ROS2 的通信中间件。
❗问题3:ros2 daemon 卡死
表现:
ros2 topic list无响应- 节点存在但 CLI 无法发现
- 需要手动
pkill
🔍 原因
ROS2 CLI 使用后台守护进程(daemon):
- 用于加速节点信息查询
- 在 WSL2 环境中容易异常
❌ 临时方案
1 | |
✅ 推荐方案(最优解)
1 | |
效果:
- 关闭 daemon
- 避免卡死
- 提升稳定性
❗问题4:环境变量未加载
表现:
ros2命令不可用- 或运行异常
✅ 解决方案
1 | |
或写入:
1 | |
四、本质总结
1. ROS2 ≠ 本地程序
ROS2 是一个基于 DDS 的分布式系统。
2. WSL2 ≠ 原生 Linux
WSL2 存在:
- 网络隔离
- 多播限制
- 进程管理差异
3. 问题本质
所有问题可以归结为:
ROS2 的分布式通信机制与 WSL2 的网络实现存在不兼容。
五、最终稳定方案
推荐在 ~/.bashrc 中增加:
1 | |
这样可以在 WSL2 下获得相对稳定的 ROS2 使用体验。
WSL2 安装 ROS2 全流程与踩坑总结(Ubuntu 22.04 + ROS 2 Humble)
https://shaoyanzhe.site/2026/03/20/WSL2-安装-ROS2-全流程与踩坑总结/