Ubuntu22系统下ROS2的完整安装与彻底卸载指南

1. 为什么选择在Ubuntu 22.04上手动安装ROS2如果你正在踏入机器人开发的世界或者正准备从ROS1迁移到ROS2那么Ubuntu 22.04 LTSJammy Jellyfish搭配ROS2 Humble Hawksbill绝对是一个黄金组合。我刚开始接触ROS2的时候也试过一些一键安装脚本虽然快但总感觉像在开盲盒出了问题都不知道从哪里查起。后来我坚持手动安装虽然步骤多点但好处是实实在在的你对系统的每一个改动都心里有数环境依赖清清楚楚后续无论是开发、调试还是最让人头疼的卸载都能做到完全掌控。Ubuntu 22.04作为一个长期支持版本提供了长达五年的稳定支持这对于需要长期迭代的机器人项目来说至关重要。而ROS2 Humble作为与Ubuntu 22.04同步发布的版本两者在底层库的兼容性上做到了最佳匹配。手动安装的过程本质上就是让你亲手搭建这个稳定、可控的开发地基。很多人怕麻烦但相信我跟着下面的步骤走一遍你不仅能成功装上ROS2更能深刻理解它的组成以后无论遇到环境问题还是依赖冲突你都能从容应对这才是真正的“上手”。准备工作其实很简单主要就两件事第一确保你的Ubuntu 22.04系统已经更新到最新状态第二有一个稳定的网络环境因为我们需要从软件源下载不少包。我建议在开始前打开终端快捷键CtrlAltT先执行一下sudo apt update sudo apt upgrade把系统现有的软件包更新一下避免一些不必要的版本冲突。好了基础打牢了接下来我们就进入正题一步步把ROS2 Humble请到你的系统里来。2. 手把手详解ROS2 Humble安装全流程2.1 配置软件源与密钥打好安装基础安装任何软件源头一定要正、要稳。ROS官方提供了全球的软件源但在国内直接访问速度可能不太理想有时甚至会因为网络问题导致失败。这里我强烈推荐使用国内的镜像源比如华为云镜像速度非常快能节省大量等待时间也避免了安装中途报错的尴尬。我实测下来用国内镜像安装过程非常顺畅。配置源的第一步就是将ROS2的软件仓库地址添加到系统的软件源列表里。Ubuntu系统管理软件源的地方主要在/etc/apt/sources.list文件以及/etc/apt/sources.list.d/目录下。为了管理方便我们通常为特定的软件如ROS2单独创建一个源列表文件。打开你的终端输入下面这条命令echo deb [arch$(dpkg --print-architecture)] https://repo.huaweicloud.com/ros2/ubuntu/ $(lsb_release -cs) main | sudo tee /etc/apt/sources.list.d/ros2.list我来拆解一下这条命令在干什么echo后面的部分是一个完整的软件源地址字符串。[arch$(dpkg --print-architecture)]会自动获取你系统的架构比如amd64或arm64确保下载正确的包。https://repo.huaweicloud.com/ros2/ubuntu/就是华为云的ROS2镜像地址。$(lsb_release -cs)这个命令会获取你系统的代号对于Ubuntu 22.04就是jammy。最后main是仓库的分支。整条命令通过管道|将地址传给sudo tee以管理员权限写入到/etc/apt/sources.list.d/ros2.list这个新文件中。命令末尾的 /dev/null只是为了让终端输出更干净不显示多余信息。光有地址还不够我们还得让系统信任这个源。软件源都有一个用于验证包真实性的加密密钥我们需要把它添加进系统的可信密钥环。继续在终端执行以下命令sudo apt install curl gnupg2 -y curl -s https://gitee.com/ohhuo/rosdistro/raw/master/ros.asc | sudo apt-key add -第一条命令安装了curl用于网络传输和gnupg2用于密钥管理这两个工具。第二条命令用curl安静地-s参数从指定的Gitee仓库获取ROS的公共密钥然后通过管道交给sudo apt-key add -添加到APT的信任密钥列表中。看到“OK”的提示就说明密钥添加成功了。这一步就像是给这个新来的软件仓库发了一张“可信通行证”。2.2 核心安装与开发工具配置源和密钥都配置好后就可以开始安装软件了。首先我们需要更新本地的软件包索引让系统知道这个新仓库里有哪些可用的软件。执行sudo apt update这个命令会扫描所有已配置的软件源包括我们刚添加的ROS2源并更新本地的软件包数据库。你会看到终端在读取我们刚添加的ros2.list源。如果这一步没有报错比如提示“忽略”“404错误”等那就说明源配置正确。接下来就是安装ROS2本体了。ROS2提供了多种“套餐”供你选择对于大多数初学者和开发者我推荐安装桌面完整版ros-humble-desktop。它包含了ROS2的核心、基础工具、图形化界面工具如RQt、经典的机器人仿真库和教程示例基本上开箱即用。安装命令是sudo apt install ros-humble-desktop输入命令后系统会列出将要安装、升级的软件包列表并询问你是否继续。这里直接输入Y并按回车确认。接下来就是一段下载和安装的过程时间长短取决于你的网速。安装过程中你可能会注意到它自动安装了很多依赖比如rclcppROS2的C客户端库、rclpyPython客户端库等等这些都是ROS2的组成部分。安装完主体后还有两个非常实用的工具推荐安装。第一个是python3-argcomplete它为ROS2的命令行工具提供了强大的参数自动补全功能。想象一下输入ros2 topic然后按两下Tab键就能列出所有可用的子命令这能极大提升效率。安装命令sudo apt install python3-argcomplete -y。第二个是colcon构建工具。这是ROS2官方推荐的编译工具用于编译你的工作空间中的ROS2包。虽然刚开始学可能用不到但一旦你要开始写自己的节点或使用第三方源码包colcon就是必备工具。安装命令sudo apt install python3-colcon-common-extensions。它会一并安装colcon-core及其一些常用扩展。2.3 环境变量设置与安装验证软件装好了但系统还不知道怎么找到它们。我们需要设置环境变量将ROS2的安装路径加入到系统的可执行文件和库文件的搜索路径中。ROS2默认安装在/opt/ros/humble/目录下。执行下面的命令可以立即为当前终端会话设置好环境source /opt/ros/humble/setup.bash执行完这条命令后你再输入ros2并按回车应该就能看到ROS2的帮助信息了而不是“命令未找到”。但这只是临时的关闭这个终端窗口下次打开又没了。为了让ROS2在每次打开终端时自动可用我们需要把这条source命令添加到用户的shell配置文件中。对于默认的bash配置文件是~/.bashrc。echo source /opt/ros/humble/setup.bash ~/.bashrc这条命令将source /opt/ros/humble/setup.bash这行文本追加到了~/.bashrc文件的末尾。为了让你当前已打开的终端也能永久生效你需要重新加载一下这个配置文件source ~/.bashrc现在大功告成了我们来做个简单的测试验证ROS2是否真的安装成功且能正常工作。ROS2贴心地提供了两个演示节点一个用C写的“说话者”talker和一个用Python写的“倾听者”listener。我们需要打开两个终端窗口。在第一个终端窗口运行ros2 run demo_nodes_cpp talker你会看到这个节点开始周期性地发布消息内容是关于计数和问候的。在第二个终端窗口运行ros2 run demo_nodes_py listener你会看到这个节点开始接收并打印出第一个终端发布的消息。如果第二个终端能持续打印出来自talker的消息比如“Hello World: X”那么恭喜你ROS2的核心通信机制——发布/订阅模型工作正常你的安装是完全成功的你可以按CtrlC来终止这两个节点的运行。3. 安装后的进阶配置与常见问题排查3.1 个性化工作空间与依赖管理安装成功只是第一步要舒服地开发我们还得布置一下“工作台”。在ROS2中你的所有自定义代码、下载的第三方功能包都应该放在一个“工作空间”里进行管理和编译。创建一个工作空间是标准操作的第一步。我习惯在用户目录下创建一个ros2_ws文件夹作为工作空间mkdir -p ~/ros2_ws/src cd ~/ros2_wssrc目录就是未来存放所有功能包源代码的地方。即使现在里面是空的你也需要先编译一次工作空间来初始化环境。在工作空间根目录~/ros2_ws下执行colcon build编译完成后你会发现目录里多了build、install、log三个文件夹。为了让系统能找到你工作空间里编译出来的包同样需要source一下工作空间的安装文件。我们可以把这条命令也加到~/.bashrc里并且放在ROS2系统环境的下面echo source ~/ros2_ws/install/setup.bash ~/.bashrc source ~/.bashrc这样每次打开终端系统会先加载ROS2的基础环境再加载你的工作空间环境你的自定义包就能被ros2命令识别了。依赖管理是另一个新手容易踩坑的地方。当你从GitHub克隆了一个功能包到src准备编译时经常会因为缺少依赖而失败。这里有个非常实用的工具rosdep。它可以自动检查并安装一个功能包声明所需的所有系统依赖。在使用前需要先初始化rosdepsudo rosdep init rosdep update然后在工作空间的src目录下你可以用rosdep install -i --from-path . --rosdistro humble -y来一键安装所有依赖。我强烈建议在每次编译新包前先运行一下这个命令能省去大量手动查找安装依赖的麻烦。3.2 安装过程常见“坑”与解决方案即使步骤再详细在实际操作中也可能遇到一些问题。这里我分享几个我踩过的“坑”和解决办法。第一个常见问题sudo apt update时报错提示“由于没有公钥无法验证下列签名”。这通常是因为密钥添加失败或未被系统完全信任。除了前面用apt-key add的方法还可以尝试用更现代的方式添加密钥sudo curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key -o /usr/share/keyrings/ros-archive-keyring.gpg然后在之前添加源的那条命令里也需要调整格式以适配这种密钥存储方式。如果问题依旧可以尝试换一个镜像源比如清华源步骤类似只是仓库地址不同。第二个问题安装ros-humble-desktop时提示某些包无法找到或版本冲突。这很可能是因为你的系统语言环境或软件源列表混乱。首先请确保你的Ubuntu系统版本是22.04而不是20.04或24.04。可以用lsb_release -a确认。其次检查/etc/apt/sources.list.d/ros2.list文件内容确认里面的Ubuntu代号是jammy。最后可以尝试运行sudo apt update --fix-missing来修复更新缓存。第三个问题运行ros2命令时提示“未找到命令”或“找不到共享库”。这说明环境变量没有正确设置。请严格按照步骤执行source /opt/ros/humble/setup.bash并确认已经将其添加到了~/.bashrc中。你可以用cat ~/.bashrc命令查看文件末尾是否有这行。添加后务必执行source ~/.bashrc。还有一个检查方法是echo $ROS_DISTRO如果设置正确它会返回humble。第四个问题运行talker和listener测试时双方收不到消息。首先确保两个终端都已经source过环境。其次检查网络ROS2默认使用DDS进行通信确保没有防火墙规则阻止了多播通信。一个简单的排查方法是在第三个终端运行ros2 topic list你应该能看到/chatter这个话题。如果能看到说明talker在正常发布。再运行ros2 topic echo /chatter看能否收到消息。这样能帮你定位问题是出在发布端、接收端还是通信中间件上。4. 如何彻底、干净地卸载ROS24.1 标准卸载流程与深度清理好了说完了安装和配置我们再来聊聊另一个重要话题卸载。你可能会因为想重装、换版本或者单纯地清理空间需要把ROS2从系统里请出去。一个不彻底的卸载会留下各种残留文件可能导致未来安装新版本时出现诡异冲突。所以要么不卸要卸就得卸干净。标准的卸载流程其实很简单主要利用APT包管理器。首先移除所有以ros-humble-开头的软件包这些就是ROS2 Humble发行版的核心包及其衍生包sudo apt remove ~nros-humble-* -y或者使用你原文中提到的方式sudo apt remove ros-humble-* -y这条命令会卸载ROS2桌面版、基础库、工具等绝大部分内容。接下来执行自动卸载不再需要的依赖包sudo apt autoremove -y这个命令会移除那些当初因为ROS2而被安装但现在没有任何其他软件依赖的库和工具。执行完后ROS2的主体部分就已经从APT的软件管理列表中清除了。但是这远未结束。APT卸载软件包通常不会删除配置文件位于/etc目录下和用户主目录下的数据文件。ROS2在运行过程中可能会在你的家目录下生成一些缓存和日志比如~/.ros/目录。此外我们手动添加的软件源文件/etc/apt/sources.list.d/ros2.list和可能导入的密钥也还在。为了做到彻底清理我们需要手动删除这些残留。4.2 残留文件清理与系统状态还原让我们来一次深度大扫除。请在你的终端中依次执行以下命令删除软件源列表文件这是我们安装时创建的。sudo rm /etc/apt/sources.list.d/ros2.list移除APT密钥如果使用apt-key方式添加可以通过列出密钥然后删除特定指纹的方式但更简单的方法是直接删除密钥环文件如果确定没有其他用途。不过更安全的方法是使用apt-key命令删除。由于我们之前可能通过不同方式添加一个通用的方法是先列出sudo apt-key list | grep -i ros找到属于ROS的密钥记下指纹后8位即可然后用sudo apt-key del 指纹删除。如果找不到或觉得麻烦一个残留的密钥对系统影响极小可以忽略。删除ROS2安装目录这是最占空间的部分所有核心文件都在这里。sudo rm -rf /opt/ros/humble/清理用户空间缓存和配置rm -rf ~/.ros/这个目录存放着ROS2运行时产生的日志、缓存和节点信息。清理环境变量设置编辑~/.bashrc文件找到并删除我们之前添加的那两行如果还添加了工作空间的source也一并删除source /opt/ros/humble/setup.bash source ~/ros2_ws/install/setup.bash你可以用文本编辑器如nano ~/.bashrc打开手动删除或者用sed命令批量删除包含特定关键词的行。删除后同样执行source ~/.bashrc使更改在当前终端生效。可选删除工作空间如果你不再需要之前创建的工作空间可以直接删除整个文件夹rm -rf ~/ros2_ws执行完以上所有步骤后建议再运行一次sudo apt update让APT刷新一下软件源列表。此时你的系统就应该恢复到一个完全没有ROS2痕迹的状态了。你可以通过尝试运行ros2命令来验证系统应该提示“命令未找到”。这样干净的状态无论是为了重新安装一个纯净的ROS2还是为安装其他版本的ROS如ROS2 Rolling或ROS1 Noetic做准备都是非常理想的起点。记住在Linux系统里做开发环境的干净和隔离至关重要养成彻底清理的习惯能让你在未来的开发路上少很多头疼事。