安装ROS2,亲测有效
在Ubuntu 22.04 LTS上安装ROS 2 Humble Hawksbill(LTS)是一个常见且推荐的选择,因为 Humble 是 ROS 2 的长期支持版本(LTS),与 Ubuntu 22.04 完全兼容。
下面提供快速安装命令版和详细步骤说明版,你可以根据需要选择阅读。
✅ 一、快速安装命令(适合有经验用户)
# 1. 设置 locale 支持 UTF-8(可选,但建议) sudo apt update && sudo apt install -y 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. 启用 Universe 软件源 sudo apt install -y software-properties-common sudo add-apt-repository universe # 3. 添加 ROS 2 GPG 密钥(使用清华镜像加速) sudo apt install -y curl gnupg sudo curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key -o /usr/share/keyrings/ros-archive-keyring.gpg # 4. 添加 ROS 2 软件源(清华镜像) echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/ros-archive-keyring.gpg] https://mirrors.tuna.tsinghua.edu.cn/ros2/ubuntu jammy main" | sudo tee /etc/apt/sources.list.d/ros2.list > /dev/null # 5. 安装 ROS 2 Humble 桌面版(含 GUI 工具) sudo apt update sudo apt install -y ros-humble-desktop # 6. 配置环境变量(每次打开终端自动生效) echo "source /opt/ros/humble/setup.bash" >> ~/.bashrc source ~/.bashrc # 7. 验证安装 echo $ROS_VERSION # 应输出 2 ros2 pkg list | grep turtlesim # 应显示 turtlesim📚 二、详细安装步骤(新手友好)
第 1 步:确认系统版本
打开终端(Ctrl + Alt + T),运行:
lsb_release -a确保输出包含Ubuntu 22.04.x LTS。
第 2 步:设置区域和编码(避免中文乱码或编译错误)
sudo apt update && sudo apt install -y 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💡 如果你习惯中文界面,只要终端不报错 GBK 等非 UTF-8 编码,也可以跳过此步。
第 3 步:启用 Universe 软件源
sudo apt install -y software-properties-common sudo add-apt-repository universe第 4 步:添加 ROS 2 软件仓库(使用清华镜像加速下载)
安装必要工具:
sudo apt install -y curl gnupg下载并添加 GPG 密钥:
sudo curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key -o /usr/share/keyrings/ros-archive-keyring.gpg添加软件源(使用清华镜像):
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/ros-archive-keyring.gpg] https://mirrors.aliyun.com/ros2/ubuntu jammy main" | sudo tee /etc/apt/sources.list.d/ros2.list > /dev/null🔍
jammy是 Ubuntu 22.04 的代号。
第 5 步:安装 ROS 2 Humble
更新软件包列表:
sudo apt update安装完整桌面版(推荐新手):
sudo apt install -y ros-humble-desktop- 包含
rviz2、rqt、turtlesim等图形工具。 - 如果你只需要核心功能(无 GUI),可安装:
ros-humble-ros-base
第 6 步:配置环境变量
让系统每次启动终端时自动加载 ROS 2 环境:
echo "source /opt/ros/humble/setup.bash" >> ~/.bashrc source ~/.bashrc⚠️ 不要修改
/etc/profile或使用 root 用户操作 ROS!
第 7 步:验证安装是否成功
方法 1:检查 ROS 版本
echo $ROS_VERSION应输出2。
方法 2:运行小海龟仿真(经典测试)
打开三个终端窗口:
终端 1:启动仿真窗口
ros2 run turtlesim turtlesim_node终端 2:启动键盘控制
ros2 run turtlesim turtle_teleop_key按方向键即可控制小海龟移动。
终端 3(可选):查看节点图
rqt_graph
如果看到小海龟窗口,并能通过键盘控制,说明安装成功!
🛠️ 可选:安装开发工具(推荐)
sudo apt install -y python3-colcon-common-extensions \ python3-rosdep2 \ python3-argcomplete \ ros-dev-tools初始化 rosdep(用于依赖管理):
sudo rosdep init rosdep update❌ 常见问题排查
| 问题 | 解决方法 |
|---|---|
ros2: command not found | 检查~/.bashrc是否包含source /opt/ros/humble/setup.bash |
apt update报错 | 清除缓存:sudo rm -rf /var/lib/apt/lists/* && sudo apt update |
| 下载慢 | 确保使用了清华/阿里云镜像(已包含在上述步骤中) |
✅ 至此,你的 Ubuntu 22.04 已成功安装 ROS 2 Humble!
接下来可以尝试编写第一个 ROS 2 节点,或学习topic、service等核心概念。
如需进一步帮助(如创建工作空间、编写发布者/订阅者),欢迎继续提问!
