本文基于真实部署环境,完整记录在栗子派昇腾 310B 开发板(Ubuntu 22.04.5 LTS,aarch64 架构)上安装 ROS2 Humble 的全流程,覆盖软件源配置、安装、环境变量与验证。

一、前置要求

项目

说明

硬件

栗子派昇腾 310B,已烧录官方 Ubuntu 22.04 LTS 镜像

系统

Ubuntu 22.04.5 LTS(Jammy),架构 aarch64(ARM64)

网络

板卡具备可用的外网出口(eth0)

权限

root 用户

二、系统环境准备(locale)

ROS2 要求系统支持 UTF-8 编码,首次安装先配置 locale:

sudo apt update
sudo apt install -y locales
# 生成 en_US.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

验证:

locale

预期输出中 LANG 与 LC_ALL 均应为 en_US.UTF-8。

三、配置 ROS2 软件源

3.1 添加 GPG 密钥

# 下载 ROS 官方签名密钥
curl -SL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key \
  -o /usr/share/keyrings/ros-archive-keyring.gpg

3.2 添加软件源

echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/ros-archive-keyring.gpg] http://packages.ros.org/ros2/ubuntu $(. /etc/os-release && echo $UBUNTU_CODENAME) main" \
  | sudo tee /etc/apt/sources.list.d/ros2.list > /dev/null

其中 $(. /etc/os-release && echo $UBUNTU_CODENAME) 会自动解析为当前系统代号 jammy,无需手动填写。

3.3 镜像源选择

官方源 packages.ros.org 位于境外,国内直连速度慢,建议替换为国内镜像。以下三个镜像均经实测可用:

镜像站

地址

华为云

https://repo.huaweicloud.com/ros2/ubuntu

中科大 USTC

https://mirrors.ustc.edu.cn/ros2/ubuntu

清华 TUNA

https://mirrors.tuna.tsinghua.edu.cn/ros2/ubuntu

替换命令(以华为云为例):

sudo sed -i 's|http://packages.ros.org/ros2/ubuntu|https://repo.huaweicloud.com/ros2/ubuntu|' /etc/apt/sources.list.d/ros2.list

镜像与官方源是同一仓库的镜像,结构和签名一致,signed-by 密钥无需更换。

四、安装 ROS2 Humble

4.1 桌面版与基础版

版本

包名

适用场景

桌面版

ros-humble-desktop

含 RViz2、rqt 等 GUI 工具,需图形环境

基础版

ros-humble-ros-base

无 GUI 依赖,适合无头(headless)部署

加速模块若做无头推理、无人车、机械臂节点部署,基础版更省空间且不引入图形依赖;本教程按桌面版记录。

4.2 同步索引并安装

sudo apt update
sudo apt install -y ros-humble-desktop python3-argcomplete python3-colcon-common-extensions

安装约下载 2GB 软件包,共约 270 余个 ROS 包。其中 python3-colcon-common-extensions 为编译工具链,用于后续 colcon build 构建工作空间。

五、配置环境变量

ROS2 命令与库依赖环境变量,需在每次会话前 source:

source /opt/ros/humble/setup.bash

写入 .bashrc 以便自动生效:

echo "source /opt/ros/humble/setup.bash" >> ~/.bashrc
source ~/.bashrc

六、验证安装

source /opt/ros/humble/setup.bash
# 查看发行版
echo $ROS_DISTRO
# 预期输出:humble

# 验证 Python 客户端库
python3 -c "import rclpy; rclpy.init(); print('rclpy OK')"
# 预期输出:rclpy OK

# 查看已安装包数量
ros2 pkg list | wc -l

两点提示:

1. ros2 --version并非有效命令,正确做法是查看ROS_DISTRO环境变量。

2. rclpy模块没有__version__属性,验证导入应直接import rclpy而非访问版本号。


结语

整个安装流程可概括为四步:配置 locale → 添加 ROS2 软件源(推荐换国内镜像)→ apt 安装桌面版/基础版 → 配置环境变量并验证。其中最容易卡住的环节是境外源下载慢,换成华为云/中科大/清华镜像即可显著提速。

如果你在昇腾 310B 上部署 ROS2 时遇到其他问题,欢迎在评论区交流补充。

Logo

作为“人工智能6S店”的官方数字引擎,为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐