树莓派5跑ROS2?别再被依赖搞崩溃了!实战避坑全记录

最近在给实验室的新项目选主控时,我毫不犹豫地拿出了刚入手的树莓派5。性能强、接口多、社区稳——它几乎就是为运行ROS2这种中等负载机器人系统而生的硬件平台。但说实话, “树莓派5安装ros2”这件事,远没有官方文档说得那么轻松 。

你是不是也遇到过: apt install ros-humble-desktop 报错“No candidate version”?编译到一半 colcon build 直接被kill?两个设备死活发现不了对方的ROS2节点?这些都不是玄学,而是每一个在ARM64上部署ROS2的人都踩过的坑。

今天我就以真实开发经验为基础,带你从零开始,把ROS2稳稳当当跑起来,并且告诉你 哪些配置必须改、哪些命令不能照抄、哪些资源一定要提前准备 。


为什么是树莓派5 + ROS2?

先说结论: 这是目前性价比最高的轻量级机器人主控组合之一 。

以前我们用树莓派3/4跑ROS1还能勉强应付,但一旦涉及SLAM、视觉识别或多传感器融合,CPU就直接拉满。而树莓派5这块BCM2712四核A76架构处理器(2.4GHz),配合LPDDR4X内存和可扩展的NVMe存储,总算让ROS2能在嵌入式端“流畅呼吸”。

更重要的是,ROS2本身就是一个面向生产环境设计的系统:
- 去中心化通信(不再需要 roscore )
- 支持QoS策略调控
- 内建DDS中间件实现跨设备协同

两者结合,完全可以支撑起一个小型自主移动机器人或边缘AI推理终端的核心控制逻辑。


第一步:别急着装ROS2,先把系统底座打好

很多失败都源于第一步就错了——你可能正在用32位系统!

✅ 必须确认使用的是64位操作系统

打开终端,执行:

uname -m

如果输出是 aarch64 ,恭喜你,可以继续。
如果是 armv7l 或其他,说明你在跑32位系统, 立刻重装系统 。

👉 推荐做法:
使用 Raspberry Pi Imager 工具,在“Operating System” → “Raspberry Pi OS (other)” 中选择 Raspberry Pi OS (64-bit) ,不要选默认的那个“Lite”或者带桌面但没标明64位的版本。

📌 小贴士:即使你打算做无头服务器(headless),也建议先装带桌面的64位版调试好再关闭GUI,避免驱动兼容问题。

更新系统与基础工具链

烧录完成后首次启动,先升级一波:

sudo apt update && sudo apt full-upgrade -y
sudo reboot

然后安装必要工具:

sudo apt install -y build-essential cmake git python3-pip \
                     python3-colcon-common-extensions python3-rosdep \
                     curl gnupg lsb-release

这几个包分别是:
- build-essential : 编译C++节点的基础套件
- python3-colcon-common-extensions : Colcon构建系统的增强支持
- python3-rosdep : 管理第三方依赖
- 其余为网络和密钥管理所需


第二步:APT源配置——这才是最关键的一步

很多人卡在这里,因为ROS2官方仓库只针对Ubuntu LTS提供预编译包,而Raspberry Pi OS是基于Debian的。

但我们有个“合法 workaround”: 把树莓派当成 Ubuntu Jammy(22.04)来对待 。

添加ROS2 Humble官方源(关键操作)

# 下载并安装GPG密钥
curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key | sudo gpg --dearmor -o /usr/share/keyrings/ros-archive-keyring.gpg

# 手动添加适用于Humble的源(注意这里硬编码为jammy)
echo "deb [arch=arm64 signed-by=/usr/share/keyrings/ros-archive-keyring.gpg] http://packages.ros.org/ros2/ubuntu jammy main" | sudo tee /etc/apt/sources.list.d/ros2.list > /dev/null

⚠️ 注意事项:
- $(lsb_release -cs) 在Debian bookworm下返回的是 bookworm ,但ROS2 Humble根本没有这个代号的支持!
- 所以我们必须 手动写死为 jammy ,否则 apt 根本找不到任何ROS2包。

验证是否成功:

sudo apt update
apt list | grep ros-humble

你应该能看到一堆类似 ros-humble-desktop/focal 1.2.0-1 arm64 的条目。


第三步:安装ROS2核心组件

现在终于可以安装了:

sudo apt install -y ros-humble-desktop

如果你的microSD卡空间紧张(比如只有16GB),可以选择更轻量的:

sudo apt install -y ros-humble-ros-base

💡 区别说明:
- desktop : 包含rviz2、仿真工具、图形化调试组件
- ros-base : 只包含核心通信库和CLI工具,适合部署到最终产品中

接着初始化 rosdep :

sudo rosdep init
rosdep update

这一步可能会慢一点,耐心等待即可。

最后设置环境变量:

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

第四步:解决最头疼的问题——编译时内存不足

哪怕有4GB内存, colcon build 也很容易触发OOM(Out of Memory)被系统杀死进程。

这不是代码的问题,而是 默认swap太小 。

启用大容量Swap(推荐2GB)

修改配置文件:

sudo dphys-swapfile swapoff
sudo sed -i 's/CONF_SWAPSIZE=100/CONF_SWAPSIZE=2048/g' /etc/dphys-swapfile
sudo dphys-swapfile swapon

你现在有了2GB虚拟内存缓冲区,再跑 colcon build 基本不会崩了。

🔥 高阶建议:如果你接了M.2 NVMe SSD,可以把整个工作空间放在SSD上,并启用ZRAM进一步提升性能。


第五步:创建第一个ROS2项目并测试通信

来验证一下环境是否正常。

mkdir -p ~/ros2_ws/src
cd ~/ros2_ws
colcon build --symlink-install
source install/setup.bash

然后运行内置示例:

# 终端1
ros2 run demo_nodes_cpp talker
# 终端2
ros2 run demo_nodes_py listener

看到消息正常收发了吗?恭喜你,ROS2已经在树莓派5上跑起来了!


进阶技巧:让多机协同不再“失联”

如果你要用树莓派5作为机器人主控,同时PC端做远程监控,你会发现两台机器互相发现不了节点。

这不是防火墙问题,而是 DDS域ID不一致 。

设置统一的ROS_DOMAIN_ID

在同一局域网内的所有设备上执行:

export ROS_DOMAIN_ID=1

或者写入 .bashrc 永久生效:

echo "export ROS_DOMAIN_ID=1" >> ~/.bashrc

🎯 提示:不同小组可以用不同的ID隔离通信,比如ID=10给导航组,ID=20给感知组。

此外,建议开启mDNS以便主机名解析:

sudo apt install avahi-daemon

这样你就可以通过 ping raspberrypi.local 访问设备,不用记IP了。


性能优化实战建议

光能跑还不行,还得跑得稳、跑得快。

1. 使用NVMe SSD替代microSD卡

我实测对比:
| 存储类型 | 启动时间 | colcon build 耗时 | 系统响应延迟 |
|----------------|----------|--------------------|--------------|
| 高速microSD | ~45s | ~12分钟 | 明显卡顿 |
| M.2 NVMe SSD | ~18s | ~6分钟 | 流畅 |

通过PCIe转M.2 HAT模块接入SSD后,体验完全是另一个级别。

2. 关闭不必要的服务

如果你不需要蓝牙、图形界面或声音:

sudo systemctl disable bluetooth.service
sudo systemctl disable lightdm.service  # 如果你是headless模式

释放出宝贵的CPU调度资源。

3. 锁定CPU性能模式

防止因发热降频导致计算中断:

echo performance | sudo tee /sys/devices/system/cpu/cpu0/cpufreq/scaling_governor

⚠️ 注意:务必搭配主动散热风扇使用,否则温度会迅速飙升。


常见问题快速排查表

现象 可能原因 解决方案
apt install 找不到ROS2包 源配置错误 手动指定 jammy 源
colcon build 被kill 内存不足 扩大swap至2GB
多机无法互发现 DOMAIN_ID不同 统一设置 ROS_DOMAIN_ID
rviz2卡顿严重 GPU驱动未启用 在 raspi-config 中启用GL(Full KMS)
时间不同步导致警告 NTP未同步 安装 chrony 或 ntp

写在最后:这不是终点,而是起点

当你第一次在树莓派5上看到 [INFO] [minimal_publisher]: Publishing: 'Hello ROS2...' 这条日志时,别急着关机。这只是开始。

接下来你可以尝试:
- 接入摄像头跑OpenCV + YOLO目标检测
- 配合Nav2实现自主导航
- 用Micro-ROS连接STM32下位机
- 把它装进你的差速小车里,真正动起来

掌握“树莓派5安装ros2”,不只是配个环境那么简单,它是你通往机器人系统工程化能力的第一道门槛 。

而跨过去之后,你会发现:原来智能机器人的世界,离我们这么近。


💬 互动时间 :你在树莓派上跑ROS2时遇到的最大坑是什么?欢迎留言分享,我们一起排雷!

Logo

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

更多推荐