ROS2 Dashing安装全攻略:从环境配置到实战避坑
如果你正在Ubuntu系统上尝试安装ROS2 Dashing,却频繁遭遇colcon not found、编码报错或各种CMake警告,这篇文章将带你一步步解决这些典型问题。不同于常规安装教程,我们将聚焦于那些官方文档没细说、但新手一定会踩的坑。
1. 环境准备:避开编码陷阱
在Ubuntu上安装ROS2 Dashing前,系统语言环境设置是第一个隐形陷阱。许多中文用户会遇到如下错误:
code复制locale::facet::_S_create_c_locale name not valid
根本原因在于ROS2的工具链对UTF-8编码有强依赖,而部分Ubuntu安装时默认使用了非UTF-8的中文环境。解决方法不是简单切换为英文,而是确保UTF-8支持:
bash复制# 先安装语言包(如果缺少)
sudo apt install language-pack-zh-hans
# 然后配置UTF-8环境
sudo update-locale LANG=en_US.UTF-8 LC_ALL=en_US.UTF-8
验证是否生效:
bash复制locale | grep -E 'LANG|LC_ALL'
预期输出应包含en_US.UTF-8。如果仍有问题,尝试:
bash复制echo "export LC_ALL=en_US.UTF-8" >> ~/.bashrc
source ~/.bashrc
注意:不要完全移除中文支持,只需确保命令行环境使用UTF-8编码。图形界面仍可保持中文显示。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 软件源配置:解决下载速度问题
官方源对国内用户可能极慢,建议替换为国内镜像。但需注意ROS2的源和Ubuntu系统源需保持一致:
bash复制# 备份原文件
sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak
# 替换系统源(以阿里云为例)
sudo sed -i 's/archive.ubuntu.com/mirrors.aliyun.com/g' /etc/apt/sources.list
# 设置ROS2源(同样使用国内镜像)
sudo sh -c
