1. 为什么要在树莓派4B上折腾ROS如果你手上正好有一块树莓派4B又对机器人操作系统有点兴趣那大概率绕不开一个念头能不能把这套东西装到这块巴掌大的板子上答案是能而且树莓派4B这块板子跑ROS的体验比前几年的树莓派3B要舒服太多了。我自己前后在4B上装过不下十次ROS从最早的踩坑到后来形成一套固定流程中间积累了不少经验这篇文章就把整个安装过程、背后的逻辑、以及那些文档里不会写的细节一次性讲清楚。先说清楚这件事的定位。ROS不是那种装完就能点图标运行的桌面软件它更像是一套通信框架加工具链的集合。你在树莓派上装ROS本质上是在给这块板子搭建一个机器人软件的运行环境。装完之后你能做什么可以跑激光雷达、可以接摄像头做图像处理、可以驱动舵机和小车底盘、可以跑SLAM建图也可以只是拿它当学习平台在真实硬件上理解话题、服务、节点这些概念。适合谁来参考如果你有一点Linux基础会用命令行知道什么是软件源那这篇内容基本可以照着走如果你完全没碰过Linux也没关系我会把每一步的意图讲清楚你照着敲也能成。树莓派4B相比前代最大的变化是内存选项多了有2G、4G、8G几个版本CPU也换成了Cortex-A72架构。这个架构对ROS来说很关键因为ROS的很多包在ARM平台上需要从源码编译而A72的性能足够让编译过程不至于让人等到睡着。另外4B的USB口和网口是独立总线的这意味着你接激光雷达或者摄像头的时候带宽不会和网络抢这在做机器人应用时是个实打实的优势。不过话说回来树莓派上装ROS和你在x86电脑上装ROS体验差别不小。x86上大部分包都有现成的二进制apt装一下就完事ARM平台上很多包要么没有预编译要么版本对不上你得自己编译。这就是为什么很多人第一次在树莓派上装ROS会卡住——他们以为和电脑上一样简单结果发现到处是坑。所以这篇文章的重点不只是告诉你敲哪些命令更重要的是告诉你为什么这么敲以及遇到问题怎么绕过去。2. 安装前的整体思路与方案选型2.1 系统版本与ROS版本的对应关系在动手之前第一件事是搞清楚版本对应关系。ROS的版本和Ubuntu的版本是绑定的而树莓派的官方系统Raspberry Pi OS虽然基于Debian但它和Ubuntu并不是一回事。这就带来一个选择你是刷Ubuntu系统还是刷Raspberry Pi OS我的建议是如果你要装ROS1优先考虑刷Ubuntu Server for Raspberry Pi。原因很简单ROS1的官方支持列表里写的就是Ubuntu你用Raspberry Pi OS虽然也能装但会遇到一些依赖包名字对不上的问题尤其是涉及到Python版本的时候。ROS1 Noetic对应的是Ubuntu 20.04ROS1 Melodic对应的是Ubuntu 18.04。树莓派4B跑这两个版本都没问题但我更推荐Noetic因为它是ROS1的最后一个版本支持周期到2025年而且Python3的支持更完善。如果你要装ROS2那选择就更多了。ROS2 Foxy对应Ubuntu 20.04Humble对应Ubuntu 22.04。ROS2对ARM的支持比ROS1好很多很多包都有预编译的deb装起来省事不少。不过ROS2的生态和ROS1还是有差异很多教程和现成的机器人代码还是基于ROS1的所以如果你是跟着某个特定项目走先确认那个项目用的是哪个版本。这里有个细节值得展开说。树莓派4B的Ubuntu镜像有两个来源一个是Ubuntu官方出的raspi镜像另一个是树莓派基金会自己维护的。我实测下来Ubuntu官方的镜像在ROS安装上更顺因为它的软件源配置和标准Ubuntu更接近。但它的缺点是默认没有桌面环境你得自己装而且WiFi配置在首次启动时需要通过cloud-init或者直接改配置文件来完成对新手稍微有点门槛。2.2 内存与存储的考量树莓派4B的内存版本直接影响你能跑什么。2G版本跑ROS1的基础功能没问题但如果你要同时跑摄像头、激光雷达和建图算法内存会吃紧。4G版本是甜点大部分场景都够用。8G版本当然更宽裕但说实话ROS在树莓派上的瓶颈往往在CPU而不是内存除非你要跑一些特别吃内存的视觉算法。存储方面我强烈建议用质量好一点的microSD卡至少32GClass 10以上。ROS装完加上常用的包轻松占掉8到10个G。如果你打算编译源码那空间还要留更多因为编译过程中的中间文件很占地方。有条件的话用USB3.0的固态硬盘启动系统速度提升非常明显尤其是编译的时候能省不少时间。树莓派4B支持从USB启动你只需要先更新一次固件然后把系统刷到硬盘上就行。还有一个容易被忽略的点是散热。树莓派4B发热比3B大不少编译ROS包的时候CPU会长时间满载如果没有散热片或者风扇很容易触发降频编译时间会成倍增加。我自己的做法是加一个金属外壳带风扇的套件编译的时候摸上去只是温温的不会烫手。2.3 网络环境与软件源在国内装ROS软件源是个绕不开的话题。ROS的官方源在国外直接连速度很慢而且经常断。所以第一步应该是把系统源换成国内镜像再把ROS的源也换成国内镜像。这个操作本身不复杂但要注意镜像的同步时间。有些镜像同步不及时你装的时候可能会遇到包版本对不上的问题。我一般会选几个大的镜像站哪个快用哪个。换源的时候有个细节Ubuntu 20.04的源配置文件在/etc/apt/sources.list但树莓派的Ubuntu镜像有时候会把额外的源放在/etc/apt/sources.list.d/下面。你换源之前先看一眼这个目录里有什么别只改了主文件就以为完事了。另外ROS的源是通过一个单独的list文件添加的通常在/etc/apt/sources.list.d/ros-latest.list你把这个文件里的地址换成镜像地址就行。网络配置还有一个坑树莓派默认的WiFi省电模式有时候会导致网络不稳定尤其是在你apt install一个大包的时候下到一半断了特别让人崩溃。你可以在/etc/rc.local里加一行关掉省电模式的命令或者直接插网线。我自己的做法是装系统的时候就用网线等ROS装完了再配WiFi这样最稳。3. 核心安装步骤与实操细节3.1 系统烧录与首次启动配置先把系统镜像下载下来。如果你选Ubuntu Server 20.04 for Raspberry Pi去Ubuntu的镜像站找raspi版本的img.xz文件。下载完之后用烧录工具写到SD卡里。烧录工具我用的是官方的Raspberry Pi Imager它里面直接有Ubuntu的选项省得你自己去找镜像。烧录的时候注意选对设备别把电脑的硬盘给写了。烧录完成后先别急着拔卡。如果你用的是Ubuntu Server需要在boot分区里放两个文件来配置WiFi和SSH。一个是network-config用来配WiFi名称和密码另一个是ssh空文件用来开启SSH服务。这两个文件的具体格式在Ubuntu的文档里有你照着改就行。如果你用的是Raspberry Pi OS那配置方式不一样是在boot分区放一个wpa_supplicant.conf文件。插卡上电等系统启动。第一次启动会比较慢因为要扩展文件系统。看到登录提示后用默认用户名和密码登录。Ubuntu Server的默认用户名是ubuntu密码也是ubuntu首次登录会强制你改密码。改完之后先做两件事一是更新系统二是配置SSH密钥登录这样以后就不用每次输密码了。更新系统的命令是sudo apt update sudo apt upgrade -y这个过程可能要几分钟到十几分钟取决于你的网络。更新完之后重启一次确保内核和固件都是最新的。3.2 换源与依赖准备系统更新完之后先把软件源换成国内的。编辑/etc/apt/sources.list把里面的archive.ubuntu.com和security.ubuntu.com替换成镜像站的地址。注意Ubuntu 20.04的源里还有ports.ubuntu.com这个也要换因为树莓派是ARM架构很多包在ports里。换完源之后执行sudo apt update如果看到速度明显变快说明换源成功了。接下来安装一些基础依赖这些依赖在后面装ROS的时候会用到sudo apt install -y curl gnupg2 lsb-release build-essential cmake git这里解释一下每个包的作用。curl用来下载文件gnupg2用来处理软件源的签名密钥lsb-release用来获取系统版本信息build-essential和cmake是编译工具git用来拉取源码。这些包在后续步骤里都会用到提前装好省得后面缺东西。还有一个重要的准备是设置locale。ROS对locale有要求如果locale没设对装的时候会报错。执行sudo locale-gen en_US en_US.UTF-8 sudo update-locale LC_ALLen_US.UTF-8 LANGen_US.UTF-8 export LANGen_US.UTF-8这几条命令的作用是生成英文UTF-8的locale并设为默认。你可能会问为什么不用中文locale因为ROS的很多工具在处理中文locale时会出问题用英文locale最省心。3.3 添加ROS软件源与密钥接下来添加ROS的软件源。首先添加密钥curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key | sudo apt-key add -如果这条命令因为网络问题失败你可以换成从镜像站获取密钥或者手动下载密钥文件再导入。密钥的作用是验证ROS软件包的签名确保你下载的包没有被篡改。然后添加源echo deb http://packages.ros.org/ros/ubuntu $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ros-latest.list这条命令会根据你的系统版本自动填入对应的代号比如focal对应Ubuntu 20.04。添加完之后把文件里的地址换成国内镜像然后再执行一次sudo apt update。这里有个细节ROS的源和系统源是分开的你换系统源的时候不会影响ROS源反之亦然。所以两个都要换。换完之后用apt-cache search ros-noetic看看能不能搜到包能搜到就说明源配置成功了。3.4 安装ROS核心包到了正式安装的环节。ROS1 Noetic的安装方式有几种我推荐装ros-noetic-ros-base也就是基础版包含了ROS的核心通信机制和基本工具但不包含桌面环境和可视化工具。为什么不全装因为树莓派的存储和性能有限桌面版会装很多你用不上的东西而且有些可视化工具在ARM上跑起来很吃力。安装命令sudo apt install -y ros-noetic-ros-base这个包的大小在几百兆左右安装时间取决于你的网络和SD卡速度。装完之后还需要装一个rosdep工具用来处理包的依赖关系sudo apt install -y python3-rosdep python3-rosinstall python3-rosinstall-generator python3-wstool build-essential然后初始化rosdepsudo rosdep init rosdep updaterosdep init这一步有时候会因为网络问题失败因为它是去国外的服务器拉一个文件。如果失败了你可以手动创建对应的目录和文件或者多试几次。rosdep update也是类似它要下载一堆索引文件网络不好的时候会很慢。我的经验是在早上或者深夜做这一步成功率会高一些。3.5 环境变量配置与验证装完之后需要把ROS的环境变量加到shell的配置里这样每次打开终端都能直接用ROS的命令。执行echo source /opt/ros/noetic/setup.bash ~/.bashrc source ~/.bashrc然后验证安装是否成功。开一个终端运行roscore如果看到类似“started core service [/rosout]”的输出说明ROS核心已经跑起来了。再开一个终端运行rosrun turtlesim turtlesim_node如果弹出一个窗口里面有一只小乌龟那说明ROS的图形化功能也正常。不过树莓派上如果没有桌面环境这个命令会报错因为turtlesim需要图形界面。你可以换成rosrun roscpp_tutorials talker这个命令会持续输出消息看到消息在滚就说明通信正常。还有一个验证方法是运行rostopic list如果能看到/rosout和/rosout_agg这两个话题说明ROS的核心话题系统在工作。4. 常见问题与排查技巧实录4.1 安装过程中的典型报错在树莓派上装ROS报错是常态不报错反而说明你运气好。我整理了几个最常见的报错和对应的解决方法。第一个是“Unable to locate package ros-noetic-ros-base”。这个报错说明你的ROS源没配好或者源里的包索引没更新。先检查/etc/apt/sources.list.d/ros-latest.list里的地址对不对然后执行sudo apt update看有没有报错。如果update的时候报“GPG error”说明密钥没导入成功重新执行导入密钥的命令。第二个是“E: Unable to fetch some archives”。这个通常是网络问题下载包的时候断了。解决办法是换一个镜像源或者多试几次。你也可以用apt的--fix-missing选项来跳过已经下载失败的文件重新下载。第三个是rosdep init报“ERROR: cannot download default sources list”。这个是因为rosdep的默认源在国外网络不通。你可以手动创建/etc/ros/rosdep/sources.list.d/20-default.list文件把里面的地址换成国内镜像。具体内容你可以搜一下网上有现成的模板。第四个是编译包的时候报“virtual memory exhausted”。这个是因为树莓派的交换空间不够。默认的交换空间只有100M或者更少编译大包的时候不够用。你可以临时增加交换空间方法是sudo fallocate -l 2G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile这样就把交换空间加到了2G编译完再关掉就行。不过要注意SD卡上的交换空间读写速度慢会增加编译时间但总比编译失败强。4.2 运行时的性能问题装完ROS之后你可能会发现树莓派跑起来有点卡。这很正常ROS本身有一定的开销加上树莓派的性能有限卡顿是难免的。有几个优化方向可以试试。一是关掉不必要的话题。ROS默认会发布很多话题有些你用不上可以在launch文件里把不用的节点关掉。二是调整发布频率。比如摄像头的发布频率默认可能是30Hz你降到10HzCPU占用会明显下降。三是用rosbag录数据的时候尽量只录你需要的话题别全录不然磁盘IO会成为瓶颈。还有一个容易被忽略的点是Python脚本的性能。ROS1里很多工具是Python写的Python在ARM上的执行效率不如x86。如果你自己写节点尽量用C性能会好很多。如果非要用Python注意避免在循环里做重计算能缓存的就缓存。4.3 网络通信与多机配置ROS的一个核心特性是分布式通信你可以让树莓派和电脑在同一个ROS网络里电脑负责可视化树莓派负责跑硬件。这个配置本身不难但有几个坑要注意。首先两台机器的ROS_MASTER_URI要指向同一个roscore。通常是在树莓派上跑roscore然后电脑上设置ROS_MASTER_URI为树莓派的IP地址。其次两台机器的ROS_IP或者ROS_HOSTNAME要设成各自的IP不能都设成localhost。最后防火墙要放行ROS用的端口默认是11311。我遇到过的一个问题是树莓派的IP地址是动态分配的每次重启都变导致电脑上的配置要跟着改。解决办法是在路由器里给树莓派绑定一个固定的IP或者在树莓派上设静态IP。设静态IP的时候注意不要和路由器的DHCP池冲突不然会出问题。还有一个问题是时间同步。ROS对时间比较敏感如果两台机器的时间差太多会出现TF变换报错。树莓派默认没有RTC断电后时间会丢所以最好装一个NTP客户端让它自动同步时间。4.4 常见问题速查表问题现象可能原因解决方法apt找不到ros包ROS源未配置或未更新检查源文件执行apt updaterosdep init失败网络不通手动创建源文件或换镜像编译时报内存不足交换空间不够临时增加swap空间roscore启动后无法通信防火墙或IP配置问题检查ROS_IP和端口运行节点时CPU占用高发布频率过高降低频率或关掉无用话题多机通信时TF报错时间不同步配置NTP同步图形工具无法启动无桌面环境改用命令行工具或装桌面安装过程中断网络不稳定换源或重试5. 装完之后能做什么ROS装好了接下来就是用它做点事情。如果你只是学习可以从turtlesim开始理解话题和服务的基本概念。然后可以试试用树莓派的GPIO控制LED写一个简单的节点订阅一个话题收到消息就点亮LED。这个练习虽然简单但涵盖了ROS开发的核心流程创建包、写节点、编译、运行。如果你想做机器人那下一步通常是接传感器。激光雷达和摄像头是最常见的。激光雷达一般通过USB或者串口连接你需要装对应的驱动包然后写一个节点把雷达数据转成ROS的LaserScan消息。摄像头的话用usb_cam或者cv_camera包就能驱动然后可以用image_transport来传输图像。再往后就是建图和导航。ROS提供了gmapping和cartographer来做SLAMmove_base来做路径规划。这些包在树莓派上都能跑但性能会有压力。我的建议是建图的时候把分辨率调低一点导航的时候把规划频率降一点这样能在性能和效果之间找到一个平衡。还有一个方向是把树莓派做成一个ROS节点和其他的ROS设备通信。比如你有一个跑ROS的电脑树莓派可以作为一个传感器节点把数据发给电脑处理。这种分布式架构能充分利用树莓派的低功耗和电脑的算力是很多实际项目的做法。6. 一些个人经验与建议最后分享几个我在树莓派上玩ROS积累的小经验。第一个是备份。每次装完一个重要的包或者配置好一个功能就用dd命令把SD卡备份成一个镜像文件。这样下次搞砸了直接恢复镜像不用从头再来。我自己的习惯是装完系统备份一次装完ROS备份一次配好硬件驱动再备份一次。第二个是日志。ROS的日志默认在~/.ros/log目录下出问题的时候先看日志大部分错误信息都在里面。如果日志太大可以设置ROS_LOG_DIR环境变量把日志放到别的地方或者定期清理。第三个是不要追求最新版本。ROS的版本更新很快但树莓派的生态跟进没那么快。你装一个最新的ROS版本可能会发现很多包不兼容。用官方推荐的稳定版本虽然功能少一点但省心。第四个是善用社区。ROS的社区很活跃你遇到的问题大概率别人也遇到过。搜索的时候用英文关键词结果会多很多。提问的时候把错误信息、系统版本、ROS版本都写清楚别人才能帮你。第五个是耐心。在树莓派上装ROS尤其是编译源码的时候等待是常态。一个包编译半小时是常有的事。你可以趁编译的时候去做别的事情别盯着屏幕看不然会很焦虑。这个内容后续还可以这样扩展你可以研究一下怎么用Docker在树莓派上跑ROS这样能避免污染主系统也方便迁移。或者研究一下ROS2在树莓派上的性能优化ROS2的架构比ROS1更适合嵌入式场景未来会越来越主流。再或者你可以把树莓派和微控制器结合起来用micro-ROS把微控制器也接入ROS网络这样能做一些更底层的控制。