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
wsl --install

安装 Ubuntu 22.04,并完成基础初始化。


2. 系统更新与基础配置

1
2
3
4
sudo apt update && sudo apt upgrade -y
sudo apt install locales
sudo locale-gen en_US en_US.UTF-8
sudo update-locale LANG=en_US.UTF-8

3. 添加 ROS2 软件源

1
2
sudo apt install software-properties-common
sudo add-apt-repository universe
1
2
3
sudo apt update && sudo apt install curl -y
sudo curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.asc | \
sudo tee /usr/share/keyrings/ros-archive-keyring.gpg > /dev/null
1
2
3
echo "deb [signed-by=/usr/share/keyrings/ros-archive-keyring.gpg] \
http://packages.ros.org/ros2/ubuntu $(. /etc/os-release && echo $UBUNTU_CODENAME) main" | \
sudo tee /etc/apt/sources.list.d/ros2.list

4. 安装 ROS2

1
2
sudo apt update
sudo apt install ros-humble-desktop -y

5. 配置环境变量

1
2
echo "source /opt/ros/humble/setup.bash" >> ~/.bashrc
source ~/.bashrc

6. 测试 ROS2

打开两个终端:

1
2
ros2 run demo_nodes_cpp talker
ros2 run demo_nodes_cpp listener

三、核心问题与踩坑总结


❗问题1:listener 无输出(节点通信失败)

表现:

  • talker 正常输出
  • listener 无任何响应

🔍 原因分析

ROS2 使用 DDS(数据分发服务)进行节点通信:

  • 节点之间通过网络发现彼此
  • WSL2 默认网络对多播(multicast)支持不完整

导致节点“互相看不到”。

✅ 解决方案

  1. 开启 WSL 镜像网络模式:
1
2
[wsl2]
networkingMode=mirrored
  1. 但该方法不完全可靠。

❗问题2:DDS 实现不稳定

默认使用 Fast DDS,在 WSL2 下容易出现:

  • 节点发现失败
  • topic 不同步

✅ 解决方案(关键)

切换为更稳定的实现:

1
sudo apt install ros-humble-rmw-cyclonedds-cpp
1
export RMW_IMPLEMENTATION=rmw_cyclonedds_cpp

本质上是更换 ROS2 的通信中间件。


❗问题3:ros2 daemon 卡死

表现:

  • ros2 topic list 无响应
  • 节点存在但 CLI 无法发现
  • 需要手动 pkill

🔍 原因

ROS2 CLI 使用后台守护进程(daemon):

  • 用于加速节点信息查询
  • 在 WSL2 环境中容易异常

❌ 临时方案

1
2
pkill -f "ros2 _daemon"
ros2 daemon start

✅ 推荐方案(最优解)

1
export ROS2_DISABLE_DAEMON=1

效果:

  • 关闭 daemon
  • 避免卡死
  • 提升稳定性

❗问题4:环境变量未加载

表现:

  • ros2 命令不可用
  • 或运行异常

✅ 解决方案

1
source /opt/ros/humble/setup.bash

或写入:

1
echo "source /opt/ros/humble/setup.bash" >> ~/.bashrc

四、本质总结

1. ROS2 ≠ 本地程序

ROS2 是一个基于 DDS 的分布式系统。

2. WSL2 ≠ 原生 Linux

WSL2 存在:

  • 网络隔离
  • 多播限制
  • 进程管理差异

3. 问题本质

所有问题可以归结为:

ROS2 的分布式通信机制与 WSL2 的网络实现存在不兼容。


五、最终稳定方案

推荐在 ~/.bashrc 中增加:

1
2
3
4
5
# 使用稳定 DDS
export RMW_IMPLEMENTATION=rmw_cyclonedds_cpp

# 关闭 daemon
export ROS2_DISABLE_DAEMON=1

这样可以在 WSL2 下获得相对稳定的 ROS2 使用体验。


WSL2 安装 ROS2 全流程与踩坑总结(Ubuntu 22.04 + ROS 2 Humble)
https://shaoyanzhe.site/2026/03/20/WSL2-安装-ROS2-全流程与踩坑总结/
作者
邵岩哲
发布于
2026年3月20日
许可协议