
1. 环境准备与基础配置在Ubuntu 22.04上安装ROS2 Humble之前我们需要先做好基础环境配置。这一步看似简单但很多新手容易忽略细节导致后续安装出现各种奇怪问题。我自己第一次安装时就因为没注意locale设置导致终端输出全是乱码。首先确保系统已更新到最新状态。打开终端CtrlAltT执行以下命令sudo apt update sudo apt upgrade -y接着配置系统语言环境这是很多教程会忽略但极其重要的一步。ROS2对UTF-8编码有强依赖如果系统语言环境配置不正确可能会导致各种编译和运行时的诡异错误sudo apt install locales 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这里有个小技巧如果你习惯使用中文界面可以同时保留中文locale只需额外添加zh_CN相关的配置。我在实际使用中发现这样既能保证ROS2正常运行又能保持系统界面的中文显示。2. 添加ROS2软件源配置好基础环境后接下来要添加ROS2的官方软件源。这里会遇到第一个常见坑点——网络连接问题。由于服务器在国外直接连接可能会很慢甚至超时。我测试过在工作日晚高峰时段裸连成功率不到50%。先安装必要的工具sudo apt install curl gnupg lsb-release然后导入官方GPG密钥。这里推荐使用国内镜像加速实测速度能提升10倍以上sudo curl -sSL https://mirrors.tuna.tsinghua.edu.cn/ros/ros.key -o /usr/share/keyrings/ros-archive-keyring.gpg添加软件源时要注意架构匹配。很多人在ARM设备上安装失败就是因为没注意这个细节echo deb [arch$(dpkg --print-architecture) signed-by/usr/share/keyrings/ros-archive-keyring.gpg] https://mirrors.tuna.tsinghua.edu.cn/ros2/ubuntu $(source /etc/os-release echo $UBUNTU_CODENAME) main | sudo tee /etc/apt/sources.list.d/ros2.list /dev/null添加完成后建议先测试下源是否可用sudo apt update如果卡住不动可以尝试换成其他国内镜像源如中科大或阿里云的镜像。3. 安装ROS2 Humble桌面版更新软件包索引后就可以安装ROS2 Humble了。这里推荐安装桌面完整版(desktop)包含常用的GUI工具和示例sudo apt install ros-humble-desktop这个安装过程可能会比较长取决于你的网速。我实测在100M宽带下大约需要15-20分钟。安装过程中最常遇到的就是依赖冲突问题特别是libsystemd0的版本冲突。如果遇到类似这样的错误ros-humble-ros-workspace : 冲突: libsystemd0 ( 249.11-0ubuntu3) 但是 249.11-0ubuntu3 正要被安装不要慌这是Ubuntu 22.04的一个已知问题。解决方法是通过临时添加特定源来更新libsystemd0echo deb http://security.ubuntu.com/ubuntu jammy-security main | sudo tee -a /etc/apt/sources.list sudo apt update sudo apt upgrade更新完成后记得把这行临时源注释掉再执行一次update和upgrade。4. 环境配置与测试安装完成后还需要配置环境变量才能正常使用ROS2命令。每次打开新终端时都需要source一下setup文件source /opt/ros/humble/setup.bash为了方便可以将其添加到.bashrc中自动加载echo source /opt/ros/humble/setup.bash ~/.bashrc source ~/.bashrc为了验证安装是否成功我们来运行经典的turtlesim demo。首先启动模拟器ros2 run turtlesim turtlesim_node然后另开一个终端启动控制节点ros2 run turtlesim turtle_teleop_key现在你应该能看到一个蓝色背景的小乌龟窗口在控制终端按方向键可以移动小乌龟。如果一切正常恭喜你ROS2 Humble已经成功安装5. 常见问题深度排解在实际安装过程中可能会遇到各种问题。下面分享几个我踩过的坑及其解决方案。问题1软件源报错No Release file这是因为系统找不到对应的软件包版本。解决方法首先是检查/etc/apt/sources.list.d/ros2.list中的Ubuntu代号是否正确。Jammy是Ubuntu 22.04的代号如果误写成focal(20.04)就会报这个错。问题2依赖关系冲突除了前面提到的libsystemd0问题还可能出现Python相关依赖冲突。这种情况下可以尝试sudo apt --fix-broken install sudo apt autoremove问题3网络连接超时如果下载速度极慢或频繁中断可以考虑使用proxychains等工具加速或者改用国内镜像源。我在实际使用中发现早上8点前下载速度最快。6. 进阶配置与优化安装完成后还可以进行一些优化配置提升使用体验。配置colcon补全colcon是ROS2的构建工具安装自动补全功能可以大大提高效率sudo apt install python3-colcon-common-extensions echo source /usr/share/colcon_argcomplete/hook/colcon-argcomplete.bash ~/.bashrc安装开发工具如果需要开发ROS2节点建议安装以下工具sudo apt install ros-dev-tools python3-rosdep python3-vcstool sudo rosdep init rosdep update配置ROS_DOMAIN_ID在多机通信时设置ROS_DOMAIN_ID可以避免网络干扰echo export ROS_DOMAIN_ID你的ID ~/.bashrc7. 维护与更新建议ROS2生态系统在持续更新建议定期检查更新sudo apt update sudo apt upgrade如果要卸载ROS2可以执行sudo apt remove ros-humble-* sudo apt autoremove记住遇到问题时第一反应应该是查看官方文档和GitHub issues。ROS2社区非常活跃大多数问题都能找到解决方案。我在实际开发中积累的经验是90%的问题都能通过仔细阅读错误信息和搜索解决剩下10%可能需要深入理解系统工作原理。