Ubuntu24.04 LTS(Noble)安装 ROS2 Jazzy 完整教程
·
重要说明:高版本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 / 仿真的完整版
更多推荐
所有评论(0)