重要说明:高版本Ubuntu24.04 没有 ROS1,仅支持 ROS2 Jazzy Jalisco

Step1:配置 Ubuntu 软件和更新(系统前置准备)

1.1 配置 UTF-8 语言环境

# 检查语言
locale
# 安装语言包
sudo apt update && sudo apt install locales
# 生成英文UTF-8
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

1.2 启用 Universe 软件仓库

sudo apt install software-properties-common
sudo add-apt-repository universe

1.3 替换国内镜像源(虚拟机加速,可选但强烈推荐)

sudo sed -i "s@http://.*archive.ubuntu.com@https://mirrors.tuna.tsinghua.edu.cn@g" /etc/apt/sources.list
sudo sed -i "s@http://.*security.ubuntu.com@https://mirrors.tuna.tsinghua.edu.cn@g" /etc/apt/sources.list
# 更新软件索引
sudo apt update && sudo apt upgrade -y

Step2:设置 ROS2 国内安装源

sudo sh -c 'echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/ros-archive-keyring.gpg] https://mirrors.tuna.tsinghua.edu.cn/ros2/ubuntu noble main" | tee /etc/apt/sources.list.d/ros2.list > /dev/null'

Step3:设置密钥 key(验证 ROS 软件包合法性)

3.1 下载 ROS 官方密钥

sudo apt install curl -y
curl -s https://mirrors.tuna.tsinghua.edu.cn/rosdistro/ros.key | sudo gpg --dearmor -o /usr/share/keyrings/ros-archive-keyring.gpg

3.2 验证密钥是否生成成功

ls /usr/share/keyrings/ros-archive-keyring.gpg
# 有文件输出即代表key配置完成

Step4:安装 ROS2 Jazzy

4.1 刷新软件源

sudo apt update

4.2 三种安装版本按需选择

(1)完整版(推荐,含 RViz、Gazebo 仿真、可视化、全套工具)

sudo apt install ros-jazzy-desktop-full -y

(2)标准版(仅基础可视化,无仿真,体积更小)

sudo apt install ros-jazzy-desktop -y

(3)极简版(仅核心库,纯开发服务器使用)

sudo apt install ros-jazzy-ros-base -y

4.3 可选:安装编译工具(后续写代码必备)

sudo apt install ros-dev-tools -y

Step5:配置环境变量(每次终端自动加载 ROS)

5.1 临时生效(当前终端)

source /opt/ros/jazzy/setup.bash

5.2 永久生效(新开终端自动加载)

# 编辑bash配置文件
gedit ~/.bashrc
# 文件末尾添加这一行
source /opt/ros/jazzy/setup.bash
# 生效配置
source ~/.bashrc

Step6:安装验证(确认成功)

打开新终端,输入测试指令:

ros2 demo_nodes_cpp talker

新开第二个终端:

ros2 demo_nodes_cpp listener

两个终端出现收发消息,代表 ROS2 安装全部完成。

常见错误:

  • 报错gedit:找不到命令:执行sudo apt install gedit安装图形编辑器,或用nano ~/.bashrc替代
  • 下载速度极慢:务必执行步骤 1.3 切换国内镜像源
  • 找不到 ros-jazzy 软件包:检查源里的系统代号是否为noble(Ubuntu24.04 代号)
  • 虚拟机无桌面:选择ros-jazzy-ros-base极简版,不要安装带 RViz / 仿真的完整版
Logo

聚焦RDK与具身智能,汇集机器人开发教程、开源案例和技术交流

更多推荐