1. 入坑前的准备为什么选 Melodic以及你要面对什么1.1 ROS 到底是什么Melodic 又是哪一路ROS 全称 Robot Operating System中文叫机器人操作系统但严格说起来它并不是真正的操作系统而是一套分布式通信框架加工具链的组合。你可以把 ROS 理解成一个“机器人的安卓系统”——它管不了最底层的硬件驱动但它把传感器、电机控制、路径规划、视觉识别这些模块用一套统一的消息机制串起来让不同语言写的节点之间能互相通信、协同工作。之所以说“不是操作系统”是因为它跑在 Linux 之上最常见的主机系统就是 Ubuntu。而 Melodic 是 ROS 的一个长期支持版本发布于 2018 年对应的系统是 Ubuntu 18.04。ROS 的版本命名按字母顺序来Melodic 是 M 开头属于 ROS 1 系列里的一个非常成熟的版本。我在入坑机器人开发时选 Melodic原因很简单当时主流的教材、开源项目、教学资源大多基于这个版本而且 Ubuntu 18.04 本身就是很多嵌入式板子和工控机的首选系统兼容性好。如果你用的是更新一点的机器也许会被建议装 Noetic对应 Ubuntu 20.04但 Melodic 依然有大量存量用户你遇到问题时几乎能搜到所有已经踩过的坑这对新手来说就是巨大的优势。1.2 安装前的系统检查清单在开始动手之前先把准备工作做扎实能省掉后面一小半的折腾时间。我见过很多同学一上来就复制命令结果装到一半发现网不好、源不对、系统版本不匹配再回头重新搞非常痛苦。先确认系统版本lsb_release -a如果输出里显示 Release 是 18.04那就可以放心往下走。如果你拿到的机器是 20.04 或者更高版本建议不要硬装 Melodic要么换系统要么直接上 Noetic因为依赖库版本不对会引发大量连锁错误。接下来确认网络环境。装 ROS 最卡的一步就是更新软件源和下载安装包网络稳定性直接影响体验。建议先测试一下ping 8.8.8.8能通不代表速度快但完全不通基本没戏。另外如果你在校园网或公司内网有时候会有特殊的网络策略建议提前确认代理设置或者换一个网络环境再操作。最后检查磁盘空间。完整版桌面安装desktop-full大概需要好几个 G 的空间加上编译缓存预留 20G 以上的空间比较稳。查看可用空间df -h做完这三项检查你的安装成功率至少能提高一半。接下来进入正式安装环节。2. 正式开装六个步骤拿下 Melodic 完整版2.1 配置软件源这一步决定你后面顺不顺软件源sources.list是 apt 下载软件包的地址仓库。ROS 官方把编译好的二进制包放在专属源里第一步就是把这个源地址加进系统。在官方教程里这一步的标准命令是这样的sudo sh -c echo deb https://mirrors.ustc.edu.cn/ros/ubuntu $(lsb_release -sc) main /etc/apt/sources.list.d/ros-latest.list注意这里我把源换成了国内镜像。原因很简单官方源在国外的服务器下载速度慢到你怀疑人生几十 KB 每秒都是常态一个包下半小时很正常。换国内镜像后速度能提升几十倍。选择镜像源的时候我建议选你所在区域延迟最低的那个。你可以在终端里用 ping 测试ping mirrors.ustc.edu.cn对比一下不同镜像的响应时间选最快的。国内几个常见镜像源都可以用我这边实测下来都挺稳定就不一一点名推荐了选一个就行。如果你只想用官方源那就写成sudo sh -c echo deb http://packages.ros.org/ros/ubuntu $(lsb_release -sc) main /etc/apt/sources.list.d/ros-latest.list但这只建议在国外服务器或者网络条件特别好的情况下使用否则你会尝到什么叫“乌龟下载速度”。2.2 添加密钥验证包来源是否可信软件源配好了还得让 apt 信任这个源。ROS 发行包都有对应的 GPG 密钥相当于包装箱上的防伪标签只有密钥验证通过apt 才会安装从该源下载的软件。添加密钥的命令sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-key C1CF6E31E6BADE8868B172B4F42ED6FBAB17C654执行后终端会输出一串 “gpg: key ... public key imported” 之类的信息这就代表密钥导入成功了。我在实际安装中发现这一步有时候会因为网络问题卡住提示 keyserver timeout。解决办法是换一个 keyserver比如sudo apt-key adv --keyserver hkp://pgp.mit.edu:80 --recv-key C1CF6E31E6BADE8868B172B4F42ED6FBAB17C654或者用国内可达性更好的 keyserver。这个报错不影响后续更新只要密钥最终导入成功就行所以耐心试几次或者换个网络环境再试。2.3 更新软件包列表密钥弄好之后先更新一下 apt 的软件包索引让系统认出新的 ROS 源sudo apt update这一步你会看到一长串更新列表耐心等它跑完。如果在输出的末尾出现 “Get: ... [ROS]” 或者类似内容说明源已经被正确识别了。我提醒一句这一步如果报错比如 “The following signatures couldnt be verified” 或者 “NO_PUBKEY”基本都是上一环节密钥没添加成功。重新执行一次密钥导入再 update 就行了。2.4 安装完整版 ROS一行命令装全部现在到了核心环节。ROS 的安装方式有好几种从最小化到完整版ros-melodic-ros-base只装核心通信功能不带任何工具和 GUIros-melodic-desktop核心功能加常用 GUI 工具没有仿真器ros-melodic-desktop-full完整版包含仿真器、导航、感知等全部常用组件对新手来说我强烈建议直接上 desktop-full省得以后缺这个缺那个到处补装。安装命令sudo apt install ros-melodic-desktop-full这一行命令会拉取几百个依赖包安装时间取决于你的网络和机器性能通常 20 分钟到 1 小时不等。装的时候不用盯着终端发呆可以去做点别的比如翻翻文档。我在第一次安装时就在这里踩过一个坑。因为中途网络闪断apt 直接把进程中断了再重新执行安装命令时提示 “Could not get lock /var/lib/dpkg/lock”。这个锁文件的作用是防止多个 apt 进程同时操作如果上次安装没正常结束锁会被一直占用。解决办法是强制解锁sudo rm /var/lib/dpkg/lock sudo rm /var/lib/dpkg/lock-frontend sudo rm /var/lib/apt/lists/lock sudo dpkg --configure -a然后重新执行安装命令就能继续了。这个解锁命令我后来在很多装机场景里都会用到算是高频救急操作。2.5 初始化 rosdep管理依赖的必备工具安装完主体之后还需要初始化 rosdep。rosdep 是 ROS 的依赖管理工具它负责帮你检查和安装某个功能包所需的系统依赖库。简单说以后你写代码编译时经常会出现 “缺少某某库” 的报错rosdep 就是帮你自动解决这些库的工具。初始化命令sudo rosdep init rosdep update这两条命令是新手安装 ROS 时最著名的“劝退点”。原因是 rosdep 默认会访问一个存储在网上的索引而这个服务在大陆地区经常连不上导致 update 卡在 “reading in raw list” 半天没动静。如果你也遇到 rosdep update 一直卡住的情况不要硬等CtrlC 中断然后考虑换一种方式。我自己用的是修改 rosdep 源的方式把默认源指向国内的可访问地址。具体做法是编辑sudo gedit /usr/lib/python2.7/dist-packages/rosdep2/sources_list.py找到DEFAULT_SOURCES_LIST_URL这个变量把它的地址替换成国内可达的源地址。不同教程里提供的替换地址不一样我不具体写哪一个你搜索 “rosdep 国内源” 就能找到当前可用的地址。替换保存后重新执行sudo rosdep init rosdep update顺利的话十几秒就能跑完。这一步做完你的 ROS 安装已经完成了百分之九十。2.6 配置环境变量与安装附属工具ROS 装好了但每次打开终端要用它还需要让终端能找到 ROS 的命令。这一步通过 source 一个 setup 脚本完成echo source /opt/ros/melodic/setup.bash ~/.bashrc source ~/.bashrc第一行把 ROS 的环境变量写进终端配置文件以后每次开新终端都会自动加载第二行让当前终端立即生效。这里有个细节如果你用的是 zsh 而不是 bash那就应该把 setup.bash 换成 setup.zsh写进~/.zshrc。我见过不少人默认 shell 是 zsh结果把 bash 的配置写错了位置怎么 source 都没反应。接下来安装几个附属工具虽然不是必需但对后续开发帮助很大sudo apt install python-rosinstall python-rosinstall-generator python-wstool build-essential这些是 ROS 开发常用的辅助工具包括创建工作区的工具、批量管理源码的工具等。装完之后整个 ROS 环境就基本齐了。3. 验证安装用内置小例程确认你的 ROS 能跑3.1 跑一次小乌龟例程装完不能光看命令返回成功就认为自己“装好了”必须实际跑一个例程来验证。ROS 自带一个著名的 “小乌龟” 仿真程序它是最简单的验证方式也是无数 ROS 学习者的第一个程序。先启动 ROS 主节点。ROS 的通信架构需要有一个中心节点来管理各节点之间的连接你可以把它理解成微信服务器——所有聊天消息都要经过它转发。启动命令roscore这一步你会看到一大串初始化信息最后在终端里持续输出说明 master 节点已经起来了。注意这个终端窗口要一直保持开着不能关掉关掉相当于服务器下线。然后新开一个终端启动小乌龟窗口rosrun turtlesim turtlesim_node一个蓝色背景的小窗口会弹出来里面有一只小乌龟这就代表 TurtleSim 节点启动成功。再新开一个终端启动键盘控制节点rosrun turtlesim turtle_teleop_key然后用键盘方向键控制乌龟移动如果乌龟跟着你的按键跑动那么恭喜你ROS 的核心功能已经完全跑通了。这一步的意义不只是让你看到一只乌龟动起来而是验证了 ROS 最核心的分布式通信机制——两个不同终端里的节点通过 master 交换消息你的键盘输入能实时转发给仿真节点。3.2 验证 rqt 图形化工具能正常启动除了核心通信再验证一下图形化工具链。rqt 是一套图形化调试工具的统称包括话题监视、节点图查看等功能。启动命令rqt_graph正常运行时会弹出一个图形界面里面能看到当前运行的节点以及它们之间的连线。如果你之前没有关掉小乌龟节点这里就能看到/turtlesim和/teleop_turtle两个节点以及它们通过/turtle1/cmd_vel话题通信的连线。看到这张图你就算是真正理解 ROS 的通信关系了因为它第一次用图形的方式把“谁在发消息、谁在收消息”展现出来了。还有几个可以顺手试的rosnode list列出当前所有运行中的节点rostopic list列出当前所有活跃的话题rostopic echo /turtle1/cmd_vel实时打印该话题上的消息内容按下键盘方向键时会看到一串 velocity 数据刷出来这几个命令能帮你把节点、话题、消息这三样 ROS 最基础的概念串起来建议每个都敲一遍对理解 ROS 工作原理非常有帮助。4. 踩坑实录新手最常见的 8 个问题与解决方案4.1 source 完还是提示 command not found这是一个非常高频的问题。明明执行了 source但输入roscore还是提示找不到命令。排查思路先确认你是否 source 对了脚本。执行ls /opt/ros/melodic/setup.bash如果这个文件不存在说明 ROS 没装成功或者装到了别的位置。如果文件存在但 command not found大概率是权限问题。检查一下ls -l /opt/ros/melodic/setup.bash正常情况是所有用户可读的。如果你是用 sudo 安装的时候就把文件权限搞歪了直接重新sudo chmod 644 /opt/ros/melodic/setup.bash就行。还有一个容易被忽略的原因你当前终端是 bash 没错但你在~/.bashrc里 source 的路径写错了单词拼写。我见过有人把 melodic 拼成 meldoic怎么都起不来。这种问题只能仔细检查配置内容。4.2 apt 安装时提示 “E: Unable to locate package ros-melodic-desktop-full”出现这种报错说明 apt 在你配置的源里找不到 ROS 包。最常见原因是软件源没配好或者源文件里写了错内容。先验证源文件内容cat /etc/apt/sources.list.d/ros-latest.list正常情况下应该有一行 deb 开头的地址。如果为空或者路径不对重新写一次。另外如果源文件里写了多个版本的源也可能冲突建议只保留一个。还可能出现另一种情况apt update 报错 “NO_PUBKEY”这代表密钥有问题。重新执行 2.2 节的密钥导入命令再 update 一次。4.3 rosdep update 更新到一半就卡死这个问题的根源在 2.5 节提过主要是网络访问问题。如果你已经换过源还是卡可以试试一个土办法反复执行 rosdep update多试几次有时候就能碰巧成功。因为它的更新逻辑是分块拉数据的某一块失败会中断但重跑时之前成功的部分会被缓存。另外注意rosdep update 卡住不一定体现在“完全不动”有时候是输出非常缓慢几分钟才刷新一点点。判断标准就是看进度是否有增长。如果连续五分钟都完全没有变化基本可以判定卡死了。还有一种情况是终端代理的问题。如果你之前配置过代理rosdep 会尝试走代理但代理本身不通就会表现为一直卡住。检查一下环境变量env | grep -i proxy有输出的话临时取消代理再试unset http_proxy unset https_proxy再执行 update往往就通了。4.4 提示 “Default Python interpreter not found”这个报错在 rosdep 初始化阶段会出现原因很简单系统找不到 python 命令。Ubuntu 18.04 默认自带 Python 2.7但如果你之前手动切换过默认 Python 版本或者系统里只有 Python 3rosdep 就会犯嘀咕。解决办法是安装 python 和 python-rosdep 相关包sudo apt install python sudo apt install python-rosdep如果你用的是 Python 3 为主的环境记得 python-rosdep 这个包要对应你系统上的 Python 版本装否则还是会出问题。4.5 小乌龟窗口能弹出来但按方向键没反应这个问题的根源通常在于焦点。你要先点击一下小乌龟窗口确保窗口有焦点然后再按方向键。因为 teleop 节点的键盘监听是依赖终端焦点的焦点不在终端上键盘事件就被图像界面窗口截获了。还有一个可能你开了不止一个终端方向键发到了别的地方。关掉多余终端确保只有 teleop 那个终端在前台。如果以上都没问题再用rostopic echo检查话题上有没有数据。没数据说明节点没跑起来有数据说明通信正常只是乌龟动不了这时候检查 turtlesim 窗口的状态。4.6 安装过程中断电或中断dpkg 报错怎么救这个问题我在前面提过锁文件的处理方式这里再补充一个更严重的情况如果中断发生在某几个包安装到一半的时候dpkg 数据库会处于不一致状态表现为任何 apt 操作都提示 “run dpkg --configure -a”。没错就是执行这个命令让 dpkg 把没配置完的包全部重新配置一遍sudo dpkg --configure -a如果它卡在某个包上出不来通常是那个包本身有问题。看看包名用sudo apt remove 包名把它移除再重新执行 dpkg configure 和 apt install。4.7 环境变量写错导致终端每次打开都报错把 source 写进~/.bashrc之后每次打开终端如果输出一大段 “bash: /opt/ros/... No such file or directory”说明你写入的路径是错的。检查一下配置tail -20 ~/.bashrc找到 ROS 相关的行确认路径是否正确。如果 ROS 安装目录确实在 /opt/ros/melodic而配置写成了别的版本改回来就行。如果在~/.bashrc里写了好多遍 source一般也不会有问题就是冗余重复 source 同一份配置是幂等的不会导致冲突。4.8 内存不足导致编译卡死如果你在执行某些工具包安装或者后来编译 workspace 时系统卡死多半是内存吃紧。Ubuntu 18.04 上面跑 ROS 的完整版加编译器内存 4G 以下会很吃力。解决办法是加一个 swap 交换分区给系统多一点“虚拟内存”。创建临时交换文件sudo fallocate -l 4G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile这样系统在物理内存不足时会把一部分数据交换到磁盘编译过程不至于被 OOM killer 干掉。这是我每次装完 ROS 后必做的一步尤其是在虚拟机或者小内存板子上非常管用。5. 安装之后做一次体检再规划学习路线5.1 安装后必做的环境体检装好 ROS跑通了小乌龟我建议你再花五分钟做一个“体检”确认环境是健康的避免以后开发到一半被奇怪的问题打断。检查 ROS 版本rosversion -d输出 melodic 就对了。检查环境变量是否完整加载env | grep ROS正常你会看到 ROS_DISTROmelodic、ROS_ROOT、ROS_PACKAGE_PATH 等一串变量。如果只有部分变量检查 source 那一步是不是没写对。检查编译环境cat ~/.bashrc | grep CMAKE_PREFIX_PATH正常情况在~/.bashrc里你 source 的 setup.bash 已经帮你把 CMAKE_PREFIX_PATH 设好了如果这位变量缺失后续编译 package 时会找不到 ROS 的库路径。还有一个容易被忽视的检查确认 roscore 能正常启动后用 CtrlC 关掉确保它能被干净地杀掉不会残留僵尸进程。因为 master 节点如果没被杀干净下次启动会提示端口占用。5.2 接下来该学什么装完 ROS 只是万里长征第一步但也是最劝退的一步。跨过这道坎后续学习就顺了。我给后来人的建议是按这个顺序学先学核心概念节点、话题、消息、服务、动作。用rostopic、rosnode、rqt_graph这些命令去实际操作比纯看理论有用得多。然后创建工作区写你的第一个发布订阅程序。用catkin_make创建一个 workspace写一个简单的 talker 和 listener 节点一边发消息一边收消息。这一步能让你真正理解 ROS 代码是怎么组织、怎么编译、怎么运行的。接着学仿真和可视化。在 Gazebo 里搭一个简单环境放一个小车模型用键盘控制它动起来。Gazebo 是 Melodic 自带的重要组件熟悉它的基本操作对后续做 SLAM、导航都很有帮助。最后开始接触真实硬件。找一块开发板或者一台小车底盘把 ROS 装上去接上激光雷达或者摄像头跑一遍点亮驱动的流程。这个阶段才算是真正跨进了机器人开发的门。另外ROS 官方有完整的教程建议把 Getting Started 部分整体过一遍再结合中文社区的文章查漏补缺学习效率会高很多。5.3 我的几个习惯建议最后分享几个我在用 ROS 过程中养成的习惯不一定适合所有人但对新手很友好。第一每新建一个工作区就把它的依赖整理清楚。用rosdep check检查缺失依赖再手动补装而不是把所有包一股脑塞进去编译否则报错的时候分不清是谁的问题。第二给终端配置区分颜色的提示符把当前在哪个 ROS 工作区标注出来。这样开着多个终端时不会搞混哪个终端在跑什么节点。第三养成用roslaunch而不是rosrun启动复杂任务的习惯。roslaunch能一次性启动多个节点、配置参数、管理节点生命周期以后做项目必然会用到。第四出了问题先查日志。ROS 的日志文件在~/.ros/log/目录下节点崩溃原因都会记录在案很多报错信息比终端里的要详细得多。我在排查难度问题的时候基本都会先翻日志再搜网络效率高很多。我个人在实际安装和使用的过程中最大的体会是ROS 的安装本身并不难难的是你对 Linux 生态的熟悉程度。如果 apt、环境变量、权限这些概念不熟每一步都可能踩坑。所以如果你觉得自己装得磕磕绊绊不一定是手气问题而是 Linux 基础还缺一块回头把命令行的基本功补补再回头装 ROS 就会觉得顺畅得多。Melodic 这套环境你装好了后面不管是刷开源算法还是转 Noetic 或者 ROS 2心智模型都是通用的。安装只是热身真正的项目还在后头。
1. 入坑前的准备为什么选 Melodic以及你要面对什么1.1 ROS 到底是什么Melodic 又是哪一路ROS 全称 Robot Operating System中文叫机器人操作系统但严格说起来它并不是真正的操作系统而是一套分布式通信框架加工具链的组合。你可以把 ROS 理解成一个“机器人的安卓系统”——它管不了最底层的硬件驱动但它把传感器、电机控制、路径规划、视觉识别这些模块用一套统一的消息机制串起来让不同语言写的节点之间能互相通信、协同工作。之所以说“不是操作系统”是因为它跑在 Linux 之上最常见的主机系统就是 Ubuntu。而 Melodic 是 ROS 的一个长期支持版本发布于 2018 年对应的系统是 Ubuntu 18.04。ROS 的版本命名按字母顺序来Melodic 是 M 开头属于 ROS 1 系列里的一个非常成熟的版本。我在入坑机器人开发时选 Melodic原因很简单当时主流的教材、开源项目、教学资源大多基于这个版本而且 Ubuntu 18.04 本身就是很多嵌入式板子和工控机的首选系统兼容性好。如果你用的是更新一点的机器也许会被建议装 Noetic对应 Ubuntu 20.04但 Melodic 依然有大量存量用户你遇到问题时几乎能搜到所有已经踩过的坑这对新手来说就是巨大的优势。1.2 安装前的系统检查清单在开始动手之前先把准备工作做扎实能省掉后面一小半的折腾时间。我见过很多同学一上来就复制命令结果装到一半发现网不好、源不对、系统版本不匹配再回头重新搞非常痛苦。先确认系统版本lsb_release -a如果输出里显示 Release 是 18.04那就可以放心往下走。如果你拿到的机器是 20.04 或者更高版本建议不要硬装 Melodic要么换系统要么直接上 Noetic因为依赖库版本不对会引发大量连锁错误。接下来确认网络环境。装 ROS 最卡的一步就是更新软件源和下载安装包网络稳定性直接影响体验。建议先测试一下ping 8.8.8.8能通不代表速度快但完全不通基本没戏。另外如果你在校园网或公司内网有时候会有特殊的网络策略建议提前确认代理设置或者换一个网络环境再操作。最后检查磁盘空间。完整版桌面安装desktop-full大概需要好几个 G 的空间加上编译缓存预留 20G 以上的空间比较稳。查看可用空间df -h做完这三项检查你的安装成功率至少能提高一半。接下来进入正式安装环节。2. 正式开装六个步骤拿下 Melodic 完整版2.1 配置软件源这一步决定你后面顺不顺软件源sources.list是 apt 下载软件包的地址仓库。ROS 官方把编译好的二进制包放在专属源里第一步就是把这个源地址加进系统。在官方教程里这一步的标准命令是这样的sudo sh -c echo deb https://mirrors.ustc.edu.cn/ros/ubuntu $(lsb_release -sc) main /etc/apt/sources.list.d/ros-latest.list注意这里我把源换成了国内镜像。原因很简单官方源在国外的服务器下载速度慢到你怀疑人生几十 KB 每秒都是常态一个包下半小时很正常。换国内镜像后速度能提升几十倍。选择镜像源的时候我建议选你所在区域延迟最低的那个。你可以在终端里用 ping 测试ping mirrors.ustc.edu.cn对比一下不同镜像的响应时间选最快的。国内几个常见镜像源都可以用我这边实测下来都挺稳定就不一一点名推荐了选一个就行。如果你只想用官方源那就写成sudo sh -c echo deb http://packages.ros.org/ros/ubuntu $(lsb_release -sc) main /etc/apt/sources.list.d/ros-latest.list但这只建议在国外服务器或者网络条件特别好的情况下使用否则你会尝到什么叫“乌龟下载速度”。2.2 添加密钥验证包来源是否可信软件源配好了还得让 apt 信任这个源。ROS 发行包都有对应的 GPG 密钥相当于包装箱上的防伪标签只有密钥验证通过apt 才会安装从该源下载的软件。添加密钥的命令sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-key C1CF6E31E6BADE8868B172B4F42ED6FBAB17C654执行后终端会输出一串 “gpg: key ... public key imported” 之类的信息这就代表密钥导入成功了。我在实际安装中发现这一步有时候会因为网络问题卡住提示 keyserver timeout。解决办法是换一个 keyserver比如sudo apt-key adv --keyserver hkp://pgp.mit.edu:80 --recv-key C1CF6E31E6BADE8868B172B4F42ED6FBAB17C654或者用国内可达性更好的 keyserver。这个报错不影响后续更新只要密钥最终导入成功就行所以耐心试几次或者换个网络环境再试。2.3 更新软件包列表密钥弄好之后先更新一下 apt 的软件包索引让系统认出新的 ROS 源sudo apt update这一步你会看到一长串更新列表耐心等它跑完。如果在输出的末尾出现 “Get: ... [ROS]” 或者类似内容说明源已经被正确识别了。我提醒一句这一步如果报错比如 “The following signatures couldnt be verified” 或者 “NO_PUBKEY”基本都是上一环节密钥没添加成功。重新执行一次密钥导入再 update 就行了。2.4 安装完整版 ROS一行命令装全部现在到了核心环节。ROS 的安装方式有好几种从最小化到完整版ros-melodic-ros-base只装核心通信功能不带任何工具和 GUIros-melodic-desktop核心功能加常用 GUI 工具没有仿真器ros-melodic-desktop-full完整版包含仿真器、导航、感知等全部常用组件对新手来说我强烈建议直接上 desktop-full省得以后缺这个缺那个到处补装。安装命令sudo apt install ros-melodic-desktop-full这一行命令会拉取几百个依赖包安装时间取决于你的网络和机器性能通常 20 分钟到 1 小时不等。装的时候不用盯着终端发呆可以去做点别的比如翻翻文档。我在第一次安装时就在这里踩过一个坑。因为中途网络闪断apt 直接把进程中断了再重新执行安装命令时提示 “Could not get lock /var/lib/dpkg/lock”。这个锁文件的作用是防止多个 apt 进程同时操作如果上次安装没正常结束锁会被一直占用。解决办法是强制解锁sudo rm /var/lib/dpkg/lock sudo rm /var/lib/dpkg/lock-frontend sudo rm /var/lib/apt/lists/lock sudo dpkg --configure -a然后重新执行安装命令就能继续了。这个解锁命令我后来在很多装机场景里都会用到算是高频救急操作。2.5 初始化 rosdep管理依赖的必备工具安装完主体之后还需要初始化 rosdep。rosdep 是 ROS 的依赖管理工具它负责帮你检查和安装某个功能包所需的系统依赖库。简单说以后你写代码编译时经常会出现 “缺少某某库” 的报错rosdep 就是帮你自动解决这些库的工具。初始化命令sudo rosdep init rosdep update这两条命令是新手安装 ROS 时最著名的“劝退点”。原因是 rosdep 默认会访问一个存储在网上的索引而这个服务在大陆地区经常连不上导致 update 卡在 “reading in raw list” 半天没动静。如果你也遇到 rosdep update 一直卡住的情况不要硬等CtrlC 中断然后考虑换一种方式。我自己用的是修改 rosdep 源的方式把默认源指向国内的可访问地址。具体做法是编辑sudo gedit /usr/lib/python2.7/dist-packages/rosdep2/sources_list.py找到DEFAULT_SOURCES_LIST_URL这个变量把它的地址替换成国内可达的源地址。不同教程里提供的替换地址不一样我不具体写哪一个你搜索 “rosdep 国内源” 就能找到当前可用的地址。替换保存后重新执行sudo rosdep init rosdep update顺利的话十几秒就能跑完。这一步做完你的 ROS 安装已经完成了百分之九十。2.6 配置环境变量与安装附属工具ROS 装好了但每次打开终端要用它还需要让终端能找到 ROS 的命令。这一步通过 source 一个 setup 脚本完成echo source /opt/ros/melodic/setup.bash ~/.bashrc source ~/.bashrc第一行把 ROS 的环境变量写进终端配置文件以后每次开新终端都会自动加载第二行让当前终端立即生效。这里有个细节如果你用的是 zsh 而不是 bash那就应该把 setup.bash 换成 setup.zsh写进~/.zshrc。我见过不少人默认 shell 是 zsh结果把 bash 的配置写错了位置怎么 source 都没反应。接下来安装几个附属工具虽然不是必需但对后续开发帮助很大sudo apt install python-rosinstall python-rosinstall-generator python-wstool build-essential这些是 ROS 开发常用的辅助工具包括创建工作区的工具、批量管理源码的工具等。装完之后整个 ROS 环境就基本齐了。3. 验证安装用内置小例程确认你的 ROS 能跑3.1 跑一次小乌龟例程装完不能光看命令返回成功就认为自己“装好了”必须实际跑一个例程来验证。ROS 自带一个著名的 “小乌龟” 仿真程序它是最简单的验证方式也是无数 ROS 学习者的第一个程序。先启动 ROS 主节点。ROS 的通信架构需要有一个中心节点来管理各节点之间的连接你可以把它理解成微信服务器——所有聊天消息都要经过它转发。启动命令roscore这一步你会看到一大串初始化信息最后在终端里持续输出说明 master 节点已经起来了。注意这个终端窗口要一直保持开着不能关掉关掉相当于服务器下线。然后新开一个终端启动小乌龟窗口rosrun turtlesim turtlesim_node一个蓝色背景的小窗口会弹出来里面有一只小乌龟这就代表 TurtleSim 节点启动成功。再新开一个终端启动键盘控制节点rosrun turtlesim turtle_teleop_key然后用键盘方向键控制乌龟移动如果乌龟跟着你的按键跑动那么恭喜你ROS 的核心功能已经完全跑通了。这一步的意义不只是让你看到一只乌龟动起来而是验证了 ROS 最核心的分布式通信机制——两个不同终端里的节点通过 master 交换消息你的键盘输入能实时转发给仿真节点。3.2 验证 rqt 图形化工具能正常启动除了核心通信再验证一下图形化工具链。rqt 是一套图形化调试工具的统称包括话题监视、节点图查看等功能。启动命令rqt_graph正常运行时会弹出一个图形界面里面能看到当前运行的节点以及它们之间的连线。如果你之前没有关掉小乌龟节点这里就能看到/turtlesim和/teleop_turtle两个节点以及它们通过/turtle1/cmd_vel话题通信的连线。看到这张图你就算是真正理解 ROS 的通信关系了因为它第一次用图形的方式把“谁在发消息、谁在收消息”展现出来了。还有几个可以顺手试的rosnode list列出当前所有运行中的节点rostopic list列出当前所有活跃的话题rostopic echo /turtle1/cmd_vel实时打印该话题上的消息内容按下键盘方向键时会看到一串 velocity 数据刷出来这几个命令能帮你把节点、话题、消息这三样 ROS 最基础的概念串起来建议每个都敲一遍对理解 ROS 工作原理非常有帮助。4. 踩坑实录新手最常见的 8 个问题与解决方案4.1 source 完还是提示 command not found这是一个非常高频的问题。明明执行了 source但输入roscore还是提示找不到命令。排查思路先确认你是否 source 对了脚本。执行ls /opt/ros/melodic/setup.bash如果这个文件不存在说明 ROS 没装成功或者装到了别的位置。如果文件存在但 command not found大概率是权限问题。检查一下ls -l /opt/ros/melodic/setup.bash正常情况是所有用户可读的。如果你是用 sudo 安装的时候就把文件权限搞歪了直接重新sudo chmod 644 /opt/ros/melodic/setup.bash就行。还有一个容易被忽略的原因你当前终端是 bash 没错但你在~/.bashrc里 source 的路径写错了单词拼写。我见过有人把 melodic 拼成 meldoic怎么都起不来。这种问题只能仔细检查配置内容。4.2 apt 安装时提示 “E: Unable to locate package ros-melodic-desktop-full”出现这种报错说明 apt 在你配置的源里找不到 ROS 包。最常见原因是软件源没配好或者源文件里写了错内容。先验证源文件内容cat /etc/apt/sources.list.d/ros-latest.list正常情况下应该有一行 deb 开头的地址。如果为空或者路径不对重新写一次。另外如果源文件里写了多个版本的源也可能冲突建议只保留一个。还可能出现另一种情况apt update 报错 “NO_PUBKEY”这代表密钥有问题。重新执行 2.2 节的密钥导入命令再 update 一次。4.3 rosdep update 更新到一半就卡死这个问题的根源在 2.5 节提过主要是网络访问问题。如果你已经换过源还是卡可以试试一个土办法反复执行 rosdep update多试几次有时候就能碰巧成功。因为它的更新逻辑是分块拉数据的某一块失败会中断但重跑时之前成功的部分会被缓存。另外注意rosdep update 卡住不一定体现在“完全不动”有时候是输出非常缓慢几分钟才刷新一点点。判断标准就是看进度是否有增长。如果连续五分钟都完全没有变化基本可以判定卡死了。还有一种情况是终端代理的问题。如果你之前配置过代理rosdep 会尝试走代理但代理本身不通就会表现为一直卡住。检查一下环境变量env | grep -i proxy有输出的话临时取消代理再试unset http_proxy unset https_proxy再执行 update往往就通了。4.4 提示 “Default Python interpreter not found”这个报错在 rosdep 初始化阶段会出现原因很简单系统找不到 python 命令。Ubuntu 18.04 默认自带 Python 2.7但如果你之前手动切换过默认 Python 版本或者系统里只有 Python 3rosdep 就会犯嘀咕。解决办法是安装 python 和 python-rosdep 相关包sudo apt install python sudo apt install python-rosdep如果你用的是 Python 3 为主的环境记得 python-rosdep 这个包要对应你系统上的 Python 版本装否则还是会出问题。4.5 小乌龟窗口能弹出来但按方向键没反应这个问题的根源通常在于焦点。你要先点击一下小乌龟窗口确保窗口有焦点然后再按方向键。因为 teleop 节点的键盘监听是依赖终端焦点的焦点不在终端上键盘事件就被图像界面窗口截获了。还有一个可能你开了不止一个终端方向键发到了别的地方。关掉多余终端确保只有 teleop 那个终端在前台。如果以上都没问题再用rostopic echo检查话题上有没有数据。没数据说明节点没跑起来有数据说明通信正常只是乌龟动不了这时候检查 turtlesim 窗口的状态。4.6 安装过程中断电或中断dpkg 报错怎么救这个问题我在前面提过锁文件的处理方式这里再补充一个更严重的情况如果中断发生在某几个包安装到一半的时候dpkg 数据库会处于不一致状态表现为任何 apt 操作都提示 “run dpkg --configure -a”。没错就是执行这个命令让 dpkg 把没配置完的包全部重新配置一遍sudo dpkg --configure -a如果它卡在某个包上出不来通常是那个包本身有问题。看看包名用sudo apt remove 包名把它移除再重新执行 dpkg configure 和 apt install。4.7 环境变量写错导致终端每次打开都报错把 source 写进~/.bashrc之后每次打开终端如果输出一大段 “bash: /opt/ros/... No such file or directory”说明你写入的路径是错的。检查一下配置tail -20 ~/.bashrc找到 ROS 相关的行确认路径是否正确。如果 ROS 安装目录确实在 /opt/ros/melodic而配置写成了别的版本改回来就行。如果在~/.bashrc里写了好多遍 source一般也不会有问题就是冗余重复 source 同一份配置是幂等的不会导致冲突。4.8 内存不足导致编译卡死如果你在执行某些工具包安装或者后来编译 workspace 时系统卡死多半是内存吃紧。Ubuntu 18.04 上面跑 ROS 的完整版加编译器内存 4G 以下会很吃力。解决办法是加一个 swap 交换分区给系统多一点“虚拟内存”。创建临时交换文件sudo fallocate -l 4G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile这样系统在物理内存不足时会把一部分数据交换到磁盘编译过程不至于被 OOM killer 干掉。这是我每次装完 ROS 后必做的一步尤其是在虚拟机或者小内存板子上非常管用。5. 安装之后做一次体检再规划学习路线5.1 安装后必做的环境体检装好 ROS跑通了小乌龟我建议你再花五分钟做一个“体检”确认环境是健康的避免以后开发到一半被奇怪的问题打断。检查 ROS 版本rosversion -d输出 melodic 就对了。检查环境变量是否完整加载env | grep ROS正常你会看到 ROS_DISTROmelodic、ROS_ROOT、ROS_PACKAGE_PATH 等一串变量。如果只有部分变量检查 source 那一步是不是没写对。检查编译环境cat ~/.bashrc | grep CMAKE_PREFIX_PATH正常情况在~/.bashrc里你 source 的 setup.bash 已经帮你把 CMAKE_PREFIX_PATH 设好了如果这位变量缺失后续编译 package 时会找不到 ROS 的库路径。还有一个容易被忽视的检查确认 roscore 能正常启动后用 CtrlC 关掉确保它能被干净地杀掉不会残留僵尸进程。因为 master 节点如果没被杀干净下次启动会提示端口占用。5.2 接下来该学什么装完 ROS 只是万里长征第一步但也是最劝退的一步。跨过这道坎后续学习就顺了。我给后来人的建议是按这个顺序学先学核心概念节点、话题、消息、服务、动作。用rostopic、rosnode、rqt_graph这些命令去实际操作比纯看理论有用得多。然后创建工作区写你的第一个发布订阅程序。用catkin_make创建一个 workspace写一个简单的 talker 和 listener 节点一边发消息一边收消息。这一步能让你真正理解 ROS 代码是怎么组织、怎么编译、怎么运行的。接着学仿真和可视化。在 Gazebo 里搭一个简单环境放一个小车模型用键盘控制它动起来。Gazebo 是 Melodic 自带的重要组件熟悉它的基本操作对后续做 SLAM、导航都很有帮助。最后开始接触真实硬件。找一块开发板或者一台小车底盘把 ROS 装上去接上激光雷达或者摄像头跑一遍点亮驱动的流程。这个阶段才算是真正跨进了机器人开发的门。另外ROS 官方有完整的教程建议把 Getting Started 部分整体过一遍再结合中文社区的文章查漏补缺学习效率会高很多。5.3 我的几个习惯建议最后分享几个我在用 ROS 过程中养成的习惯不一定适合所有人但对新手很友好。第一每新建一个工作区就把它的依赖整理清楚。用rosdep check检查缺失依赖再手动补装而不是把所有包一股脑塞进去编译否则报错的时候分不清是谁的问题。第二给终端配置区分颜色的提示符把当前在哪个 ROS 工作区标注出来。这样开着多个终端时不会搞混哪个终端在跑什么节点。第三养成用roslaunch而不是rosrun启动复杂任务的习惯。roslaunch能一次性启动多个节点、配置参数、管理节点生命周期以后做项目必然会用到。第四出了问题先查日志。ROS 的日志文件在~/.ros/log/目录下节点崩溃原因都会记录在案很多报错信息比终端里的要详细得多。我在排查难度问题的时候基本都会先翻日志再搜网络效率高很多。我个人在实际安装和使用的过程中最大的体会是ROS 的安装本身并不难难的是你对 Linux 生态的熟悉程度。如果 apt、环境变量、权限这些概念不熟每一步都可能踩坑。所以如果你觉得自己装得磕磕绊绊不一定是手气问题而是 Linux 基础还缺一块回头把命令行的基本功补补再回头装 ROS 就会觉得顺畅得多。Melodic 这套环境你装好了后面不管是刷开源算法还是转 Noetic 或者 ROS 2心智模型都是通用的。安装只是热身真正的项目还在后头。
