ROS学习笔记Ubuntu 常用命令实操手册写这篇东西的起因很朴素就是我自己刚入坑 ROS 的时候被 Ubuntu 命令狠狠折磨过。那时候一边开着 ROS 官方 Wiki一边开着 Linux 命令手册敲个roscd都要先想半天自己现在在哪个目录。后来踩的坑多了慢慢整理出一套自己用得最顺手的命令清单。这篇笔记不打算写成命令大全那玩意儿网上到处都是我重点写 ROS 开发中真正高频、真正能帮你省时间的那些 Ubuntu 操作顺手把每个命令为什么要这么用、什么时候会踩坑讲清楚。如果你正在学 ROS或者刚把 Ubuntu 装好准备入门又或者已经跑通了一些小例程但总感觉对系统不熟这篇应该都能帮到你。内容会涉及环境准备、文件权限、进程网络、日志排查这几个和 ROS 开发最相关的方向。每个命令我都会结合真实开发场景来讲不是干巴巴背诵参数。1. 为什么 ROS 学习者必须先啃 Ubuntu 命令ROS 官方对 Ubuntu 的支持最完善这一点不用怀疑。绝大多数教程、二进制包、社区解决方案都默认你跑的是 Ubuntu 某个 LTS 版本。从 Noetic 到 Humble再到后来的版本虽然底层有变化但你在终端里敲命令的习惯基本是通用的。另一个原因是 ROS 的开发模式天然依赖命令行。你要启动节点用的是ros2 launch或者roslaunch你要查看话题列表用的是rosnode list或者ros2 topic list你要调试程序经常得边改代码边在终端里看日志输出。如果你连切换目录、查看文件内容、搜索日志这种基础操作都要想半天那学习节奏会被拖得很慢。还有一个冷门的点很多人没意识到ROS 社区里的问题解答几乎全是命令行操作。你在网上搜到一个报错老手回复的第一句话往往是“你先跑一下ls -l /dev/ttyUSB0看看权限”或者“用df -h看看磁盘是不是满了”。你要是连这些命令都看不懂连求助都没法求助。所以我一直觉得把 Ubuntu 常用命令练熟不是学习 ROS 之前的“前置任务”它本身就是 ROS 开发能力的一部分。下面就从我实际用得最多的场景开始讲大家可以直接照着敲。1.1 装好系统后的第一轮“体检命令”我见过太多人装完 Ubuntu 就急着去装 ROS结果装到一半各种报错。绝大多数报错的根源其实在装系统那一步就埋下了。所以我强烈建议装完系统先花五分钟做一轮体检用到的命令不多但信息量很大。第一个是lsb_release -a。它能显示当前 Ubuntu 的版本号比如 20.04、22.04 这种。为什么要先看它因为 ROS 版本和 Ubuntu 版本是绑定的。Ubuntu 20.04 对应 ROS NoeticUbuntu 22.04 对应 ROS 2 Humble。你要是版本对不上软件源里的 ROS 包根本装不进去或者装进去了一堆依赖冲突。这属于查问题前最先要确认的信息。第二个是df -h查看磁盘空间。ROS 的完整安装大概需要好几个 GB 的空间如果装了 Gazebo 仿真、RViz 这些重型工具再加上编译缓存空间占用会涨得很快。我自己的习惯是根目录剩余空间低于 15GB 就有点慌低于 10GB 基本就该清理了。顺便说一句df -h里那个h参数代表 human-readable也就是显示成 G、M 这种单位不加的话显示的是字节数看起来不够直观。第三个是free -h查看内存。编译 ROS 功能包时内存不够会直接导致编译被杀死现象就是终端里出现Killed字样。我实测下来编译比较大的工作空间8GB 内存会比较勉强16GB 就舒服多了。如果内存不够又暂时没法升级硬件可以临时加 swap 空间这个后面排查章节会讲。1.2 一键安装脚本到底帮你干了什么现在的 ROS 学习者应该都听说过鱼香 ROS 的一键安装脚本很多新手第一个问题就是这东西靠谱吗我的看法是你要真明白它替你做了什么那你用起来心里就有底。鱼香的脚本本质就是把 ROS 官方或社区推荐的安装步骤封装成自动化脚本。你自己手动装的话步骤大致是添加软件源、添加密钥、apt update、再安装 ros 的某个发行版桌面完整版。这里面的坑很多比如网络环境不好导致添加密钥超时软件源地址被墙导致下载缓慢依赖冲突导致安装中断。脚本的存在就是把这些步骤集成到一起提高成功率。但我想强调的是一键装完并不代表一劳永逸。装完 ROS 之后你还要配置环境变量也就是在~/.bashrc里加一行source /opt/ros/noetic/setup.bash或者source /opt/ros/humble/setup.bash。这个手动配置的过程反而很适合用来理解 ROS 的工作原理。你没搞懂 source 是什么概念后面每次打开新终端都发现ros命令找不着你又得一脸懵地百度。这里我给一个建议用一键脚本没问题但装完之后自己动手在终端里敲一遍source命令、检查一下echo $ROS_DISTRO能不能输出版本号再打开一个新终端验证环境变量自动生效。这套动作做下来你对 ROS 环境配置的理解会比照着教程敲十遍命令都深。2. 文件与权限ROS 开发中绕不开的“拦路虎”从 Windows 转过来的朋友在 Ubuntu 上遇到的第一个心理冲击就是权限系统。你明明在图形界面里把文件拖到了某个文件夹结果命令行里一操作就提示 Permission denied。还有一个经典场景你的串口设备明明插上了ROS 节点却打不开摄像头或雷达报错说没权限。这不怪你这是 Linux 的设计哲学跟你熟悉的那套完全不同。但好消息是你只需要掌握几个关键命令权限问题就再也不会卡住你。2.1 用 ls 和 file 把文件认清楚ls是每个 Linux 用户都会的第一个命令但很多人的理解停留在“列出文件名”这个层面。你其实应该把它当成一个文件信息查看器。ls -l能显示每个文件的权限、属主、属组、大小、修改时间这些信息在调试 ROS 包时特别重要。我举个例子你下载了一个 ROS 功能包源码解压之后准备编译结果catkin_make的时候报错说某个脚本没有执行权限。这时候你跑ls -l一看发现那个.sh文件的权限位是-rw-r--r--也就是没有可执行权限。解决办法就是用chmod x给它加上执行权限。这个场景我遇到过不下三次现在每次拿到一个陌生脚本都会下意识先看一眼权限位。file命令也值得养成习惯。它用来判断文件真实类型不看后缀名。为什么这个有用因为 ROS 的日志文件、bag 包rosbag 记录的数据文件、配置文件很多都是文本或特定二进制格式。你拿到一个未知扩展名的文件用file一看就知道是文本、压缩包还是可执行程序然后再决定用什么工具处理。这个命令很小众但实际开发中特别顺手。2.2 chmod 和 chown权限问题急救包权限操作的核心是chmod和chown。先说 chmod它的参数有两种表示方法一种是用数字一种是用字母。初学者有时候会被数字搞晕其实逻辑很简单读是 4写是 2执行是 1把它们相加就得到一个权限值。7 代表读写执行5 代表读执行4 代表只读。实际的 ROS 开发里最常见的需求就是给设备接口加权限。比如你用 USB 口连接激光雷达设备节点是/dev/ttyUSB0每次插上都要手动sudo chmod 777 /dev/ttyUSB0。这里我要强调一下777是“所有人可读可写可执行”这个权限很开放日常练习没问题但在正式项目或者多人协作的环境里应该尽量用更精确的方式比如把用户加入 dialout 组用sudo usermod -aG dialout 用户名来管理。这样既解决了权限问题又不会把系统搞得太随便。chown 的作用是修改文件属主和属组。这个命令在 ROS 开发里用得相对少一点但你如果从别人那里拷贝了一个工作空间编译时发现权限不对就可能需要sudo chown -R 用户名:用户名 目录路径来把所有权改回来。这个-R参数代表递归会把目录里所有子文件一起改。2.3 在 ROS 工作空间中如何安全地“删改查”在 ROS 工作空间里最常用的文件操作其实是cd、pwd、mkdir、cp、mv、rm这几个。听起来简单但我见过不少人在rm上翻车。rm是删除命令危险系数极高。因为你一旦删掉默认情况下是找不回来的Ubuntu 的图形界面有回收站但终端里的rm没有。我强烈建议刚学 ROS 的朋友尽量别用rm -rf特别是别在路径前面加上sudo。我身边真实发生过的事有人想删掉 build 目录重新编译结果手一抖在rm -rf后面多打了个空格把整个工作空间删掉了。那感觉真的是欲哭无泪。如果你确实需要删除目录我建议先用rm -r它会逐个子目录询问确认。虽然慢一点但能给你留出反应时间。如果你要重新编译 ROS 工作空间更稳妥的做法是用catkin_make或者colcon build的清理机制而不是手动删 build 和 devel 目录。有些版本的 ROS 有 clean 参数能帮你把编译缓存清干净比手动物理删除安全得多。3. 进程、网络与多机通信从“能跑”到“跑得明白”ROS 的核心机制是节点通信。你在一个机器人上跑了好几个节点有控制底盘的、有处理传感器数据的、有做导航规划的它们之间靠话题和服务通信。这个过程涉及两个层面的操作一个是系统层面的进程和网络管理一个是 ROS 层面的节点和话题管理。很多初学者卡住的地方在于分不清哪个报错是系统层面引起的哪个是 ROS 配置引起的。这里我教你一套我最常用的排查思路。3.1 用 top 和 ps 看清系统到底在忙什么你启动一个 ROS 节点之后如果发现机器人响应迟钝或者 RViz 画面卡顿第一反应应该是看系统负载而不是急着改代码。用top命令可以看到 CPU 和内存的实时占用按P键可以按 CPU 使用率排序按M键可以按内存排序。我经常用这个方法来定位到底哪个节点在吃资源。ps命令则更适合快速查进程。ps aux能列出所有进程的信息配合grep过滤可以直接找到某个 ROS 节点的进程号和状态。比如我想确认摄像头驱动节点是不是真的在运行就输入ps aux | grep camera如果看到对应的进程还在说明它没有意外退出如果进程不在了那就得去查日志看是崩溃了还是被系统杀了。这里有个细节ROS 节点有时会因为内存不够被系统 OOM Killer 杀掉。现象就是运行一段时间的节点突然消失而ps查不到进程。这时候用dmesg查看内核日志能看到类似于 “Out of memory: Kill process” 的记录这样你就知道问题根源是内存不足而不是程序本身写崩了。3.2 网络配置的核心命令ifconfig、ping、sshROS 的多机通信是另一个高频需求。比如你有一台高性能台式机跑导航算法一个小车控制器跑底盘驱动两者要通信就得依赖网络。ROS 在不同机器之间通信靠的是 ROS MasterROS1或 DDS 发现机制ROS2但不管哪种机制底层都要求机器之间能互相 ping 通。ifconfig或者更新的ip addr用来查看本机 IP 地址。很多人到了这一步才意识到自己的机器人终端连接的网络和电脑连接的网络根本不在同一个网段那就是怎么配置都白搭。所以我习惯第一步先用ifconfig确认 IP再用ping测试连通性。ping能通不代表 ROS 通信就没问题但如果ping都不通那 ROS 通信必然有问题。还有一个常见的命令是ssh用来远程登录机器人的工控机。你不可能每次都抱着显示器去连机器人所以学会用 SSH 远程操作是基本功。我自己的习惯是给机器人设一个固定的 IP然后在电脑上配置~/.ssh/config这样每次连接只需要输入一个简短的别名省去记 IP 的麻烦。ROS 多机通信的具体配置还有个关键参数是ROS_MASTER_URIROS1或者配置文件里的 DDS 发现设置。很多教程会直接教你在一台机器上export ROS_MASTER_URIhttp://192.168.x.x:11311但要注意这个设置在两台机器上必须保持一致而且主机名解析也要正确不然你会遇到节点找不到对方的诡异问题。3.3 多个节点抢话题用 rostopic 来决策我记得热搜词里有一条很生动的“ROS 多个节点发布移动指令话题时底盘节点如何取舍”。这个问题的本质是同一个话题有多个发布者订阅者怎么处理。在 ROS 中订阅者会收到所有发布者的消息不存在“自动取舍”这回事。如果你同时跑了键盘控制节点和自主导航节点它们都往cmd_vel话题发速度指令底盘节点就会收到两路指令表现出来就是小车一会儿听键盘的一会儿听导航的非常混乱。解决办法一般是在应用层做仲裁或者只让一个节点发布者处于运行状态。这个场景里rostopic list和rostopic echo就是你的好帮手。先用rostopic list查看当前有哪些话题在发布再用rostopic echo /cmd_vel实时查看话题内容你就能看到是谁在发送移动指令频率是多少内容合不合理。如果你发现底盘接收到的速度指令忽大忽小十有八九是多个发布者互相干扰。rostopic hz也很有用它统计话题的发布频率。比如你期望导航节点以 10Hz 的频率发布指令但实际测试只有 2Hz那就要检查上游节点可能是计算量太大也可能是话题队列设置不合理。这套排查思路比瞎改代码高效得多。4. 日志、驱动与系统破损真正的硬骨头在这里ROS 开发到后面真正折磨人的往往不是 ROS 本身而是 Ubuntu 系统层面的各种小毛病。我这部分专门写一写我实际踩过坑、也帮别人排查过的高频问题。每一个问题都是我亲手折腾过好几个小时才弄明白的希望你们能少走弯路。4.1 查看日志的通用套路journalctl、roscd log、dmesg碰到问题不会查日志等于闭着眼睛走夜路。我先说几个最重要的日志入口。Ubuntu 的系统服务日志用journalctl查看。比如你发现某个系统服务起不来可以journalctl -u 服务名查看对应的日志。ROS 节点自身的日志则放在~/.ros/log目录下你可以用roscd log直接跳转到这个目录然后用ls -t按时间排序找到最新的日志文件。很多节点崩溃的原因在最后几行日志里写得明明白白。dmesg是内核日志的查看工具它特别适合排查硬件相关的问题。比如你插上了一个 USB 摄像头但是 ROS 里打不开设备dmesg可能会显示驱动加载失败或者usbfs缓冲大小的警告。我之前用海康相机的时候就遇到过dmesg里疯狂刷 USB 缓冲不足的日志后来通过调整usbfs内存大小解决的。还有一个容易被忽略的点ROS 的日志文件会随着运行时间增长变得很大长期不清理会吃掉磁盘空间。我建议每隔一段时间用du -sh ~/.ros/log看一眼大小必要时手动删掉旧日志。这属于保洁工作但能避免很多莫名其妙的故障比如磁盘满了导致节点无法写入临时文件。4.2 摄像头、显卡与串口设备驱动问题的三板斧摄像头在 ROS 里几乎是必踩的坑。系统自带摄像头打不开报/dev/video0权限不够这种问题在 Ubuntu 上尤其常见。原因就是当前用户不在video组里。解决办法是sudo usermod -aG video 用户名然后重新登录生效。如果权限没问题但图像还是黑的那就要检查驱动。lsusb能看到 USB 设备是否被系统识别v4l2-ctl --list-devices能看到视频设备节点。跑一下这两个命令基本能定位是硬件没识别到还是软件层面被占用。显卡驱动的坑就更经典了。Ubuntu 装好之后用的是开源驱动如果你想用 GPU 跑一些视觉算法往往需要安装 NVIDIA 闭源驱动。nvidia-smi命令能查看显卡驱动状态和 GPU 利用率。我见过很多人安装驱动失败然后系统陷入循环登录或黑屏其实就是版本不对或者没处理干净旧驱动。我的建议是驱动这种东西能不折腾就不折腾除非你的项目确实需要 GPU 加速。如果你非要装一定提前在命令行里备好恢复方案不然图形界面挂了连终端都进不去。4.3 软件安装失败与中文输入法新手的日常崩溃区apt是 Ubuntu 安装软件的主要方式但它经常会因为依赖问题、软件源问题、半途中断而卡住。一个经典场景是你装到一半断电了再开机电apt install就报错。解决办法通常是用sudo dpkg --configure -a修复中断的安装过程。还有一个很常见的问题是安装编译工具时失败。比如sudo apt install gcc报依赖错误。我的经验是先apt update让软件源刷新一遍如果还不行可以apt --fix-broken install让系统自动修复损坏的依赖关系。大部分情况下这两板斧下去问题就解决了。至于中文输入法这是每个中文用户刚装完 Ubuntu 都要面对的问题。最省心的方案是装搜狗输入法或者设置系统自带的 IBus 框架。我在实践中发现一旦装完输入法最好重启一次系统或者重新登录让输入法框架正确加载否则怎么切换都打不出中文。系统设置里还要把输入源添加好不然你装了输入法也调不出来。这里有个小技巧在终端里可以用fcitx5-configtool或者ibus-setup检查输入法框架是否正常启动比在图形界面里乱点更直接。4.4 磁盘空间、swap 与系统重装的底线思路磁盘空间的问题前面已经提过这里重点说 swap。如果你的 Ubuntu 内存确实不够用加 swap 是性价比最高的应急方案。Ubuntu 系统的 swap 文件是可以动态调整的。我的建议是不要只加到 2GB对于要编译大型程序的情况加到 8GB 甚至更多都不过分。创建一个 swap 文件的命令是sudo fallocate -l 8G /swapfile然后sudo mkswap /swapfile再sudo swapon /swapfile。这套操作一做完内存不够导致编译被杀的问题基本都能缓解。至于系统重装我要说一个反直觉的经验比起反复折腾修复一个已经千疮百孔的系统重装往往更省时间。尤其是你在系统里装过很多不兼容的驱动、跑过各种一键脚本之后系统状态会变得很混乱再去修复可能花掉半天时间。不如备份好工作空间和重要文件直接重装一个干净的 Ubuntu然后老老实实按教程一步步来。重装前要用到的备份命令主要是rsync和scp。rsync适合本地目录同步或者配合 SSH 在远程机器间同步。你要是怕忘可以把要备份的目录写在一个脚本里每次重装前跑一遍脚本就完事。5. 一个 30 分钟的 ROS 环境实战串联所有命令前面讲了很多零散的命令我知道你们需要一个能把它们串起来的实际案例。这里我就用一个迷你实战来收尾你不用做任何复杂配置只需要有一个能跑 ROS 的环境就行。要是你还没装好 ROS前面几章提到的安装和体检命令正好派上用场。目标是从零开始创建一个 ROS 工作空间启动一个话题发布节点然后用命令行去探查它的状态。整个过程会用到文件操作、进程查看、话题工具、权限确认正好是一个命令行小综合。5.1 创建工作空间时的每一步命令在终端里输入下面这一串ROS1 Noetic 版本为例mkdir -p ~/catkin_ws/src cd ~/catkin_ws/src catkin_init_workspace cd ~/catkin_ws catkin_makemkdir -p的-p参数会自动创建中间层级的目录你不用担心一次性要建多级目录导致报错。catkin_init_workspace会在 src 目录下创建 CMakeLists.txt 符号链接标志着这里是一个工作空间。catkin_make则是在工作空间根目录生成build和devel两个目录前者是编译产物后者是环境变量配置目录。我建议你在这个阶段跑一个tree -L 2看看目录结构如果没有 tree 就sudo apt install tree装一下这会让你对 ROS 工作空间的布局有直观印象。很多教程直接告诉你“把包放进 src 目录”但没告诉你整个空间的结构长什么样导致后面经常迷路。工作空间建好之后需要把环境变量加进~/.bashrcecho source ~/catkin_ws/devel/setup.bash ~/.bashrc source ~/.bashrc这里有个我很想强调的细节echo ... 是把内容追加到文件末尾两个尖括号和单个尖括号意义完全不同。如果你用了单尖括号那会把文件原有内容整个覆盖掉.bashrc里的其他配置就全没了。我见过不止一个人在这里翻车所以特别提醒一下。5.2 启动节点并实时“体检”它假设你在自己的工作空间里写了一个最简单的发布器节点启动后它会往/chatter话题发消息。启动命令是rosrun beginner_tutorials talker这时候终端会持续刷出消息看着好像没问题。但真正的排查动作在后面我建议你另开一个终端依次输入rosnode list rostopic list rostopic echo /chatter rostopic hz /chatterrosnode list查看当前有哪些节点rostopic list查看当前有哪些话题。这两个命令可以帮你确认节点是否真的注册到了 ROS Master。rostopic echo能看到消息具体内容rostopic hz能统计发布频率。如果rostopic list看不到/chatter话题但发布节点那边一直在刷消息那问题几乎都在 ROS Master 上。你可以在终端跑echo $ROS_MASTER_URI检查 Master 地址对不对。很多人在多机通信或者本机调试时被这个问题折磨其实根源往往就是环境变量没配对。5.3 收尾动作背后的系统命令实战的最后一步是学会如何优雅地停掉节点。直接关闭终端窗口是一种办法但不优雅而且容易留下僵尸进程。我建议的方式是回到启动节点的那个终端按CtrlC发送中断信号节点会执行清理逻辑再退出。如果你想强制终止一个卡住的节点可以先ps aux | grep talker找到 PID然后kill PID或者更暴力一点kill -9 PID。我要特别强调kill -9是最后手段它不会给进程任何清理机会可能留下锁文件或者没有释放的共享内存。能用CtrlC就不用kill能用kill就不用kill -9这个是 Linux 进程管理的“道”。另外如果节点退出了但话题还残留在rostopic list里那说明可能有节点没退干净再用rosnode cleanup清理一下。这个命令会把那些已经失联的节点信息从 Master 里清掉免得后面排查问题时被残留信息误导。6. 写在最后的经验之谈这十几个高频场景和对应的命令基本覆盖了 ROS 开发日常会用到的 Ubuntu 操作。我真心觉得学好这些命令最有效的方式不是背而是真的把它用进自己的项目流程里。你每换一台新电脑、每装一个新环境、每调试一个诡异 bug都是练熟命令的好机会。我个人习惯是把高频命令做成一个速查卡片放在手边。不一定非要用什么高级工具一个简单文本文件就行。遇到一次记不住就翻卡片敲一次敲到第三次基本就形成了肌肉记忆。另外有个小技巧碰到搞不定的问题先把你输入的完整命令、完整的报错日志、还有系统环境信息比如版本号、内核版本一起记录下来再去搜索或者提问。多花这几十秒记录时间后面排查能省下几个小时。