Ubuntu安装ROS2完整教程和踩坑经历

最新推荐文章于 2025-05-17 16:25:38 发布

Raine_Yang

最新推荐文章于 2025-05-17 16:25:38 发布

阅读量6.4k

点赞数 4

CC 4.0 BY-SA版权

分类专栏：实习记录 ROS2学习笔记文章标签： ubuntu 自动驾驶 linux

本文链接：https://blog.youkuaiyun.com/Raine_Yang/article/details/125287580

本文提供了一步一步在Ubuntu 20.04 LTS系统上安装ROS2 Foxy的教程，包括设置编码、添加源、解决网络问题、安装过程中的公钥添加以及如何更换为国内源来解决下载问题。通过这个教程，读者可以了解完整的安装流程，并解决可能遇到的常见问题。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

使用设备：
虚拟机，Ubuntu 20.04LTS系统
安装ROS2 Foxy

1 设置编码：

sudo apt update
sudo apt install locales
sudo locale-gen en_US en_US.UTF-8
sudo update-locale LC_ALL=en_US.UTF-8 LANG=en_US.UTF-8
export LANG=en_US.UTF-8

2 添加源

sudo apt update
sudo apt install curl gnupg lsb-release

sudo curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key -o /usr/share/keyrings/ros-archive-keyring.gpg

到这一步很大概率会报错：
在这里插入图片描述
这里首先查找raw.githubusercontent.com的IP地址：：https://www.ipaddress.com
把找到的IP地址复制到host文件

sudo gedit /etc/hosts

加入地址：

185.199.108.133 raw.githubusercontent.com

（前面的IP地址以查到的数字为准）

下一步：

sudo sh -c ‘echo “deb [arch=amd64,arm64] http://packages.ros.org/ros2/ubuntu lsb_release -cs main” > /etc/apt/sources.list.d/ros2.list’

3 安装ROS2

sudo apt update
sudo apt upgrade

对于新加入的源，这一步可能出现没有公钥，由于安全问题不可更新
在这里插入图片描述
报错信息会提示要加入的公钥，输入以下指令：

gpg --keyserver keyserver.ubuntu.com --recv (要加入的公钥)
apt-key adv --keyserver keyserver.ubuntu.com --recv-keys (要加入的公钥)

sudo apt install ros-foxy-desktop

这一步很可能出现网络连接不稳定，导致无法下载。这是使用默认国外的源造成的。

sudo gedit /etc/apt/sources.list

把原有的国外源改为清华源（注意对原文件备份）

# 默认注释了源码镜像以提高 apt update 速度，如有需要可自行取消注释
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal main restricted universe multiverse
# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-updates main restricted universe multiverse
# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-updates main restricted universe multiverse
deb https://mirrors