Ubuntu 20.04源码编译ROS2 Humble避坑指南从崩溃边缘到完美运行当你在Ubuntu 20.04上尝试源码编译ROS2 Humble时官方文档看起来就像是一份完美的食谱——直到你真正开始动手。作为一名经历过无数次失败才最终成功的开发者我想分享那些官方文档没告诉你的关键细节和解决方案。1. 环境准备那些容易被忽略的细节在开始之前大多数人会直接跳到安装步骤但环境配置中的小细节往往决定了整个过程的成败。1.1 系统基础配置首先检查你的Ubuntu 20.04系统是否满足以下基本要求GCC版本至少需要GCC 7以上但建议使用GCC 9或10Python版本ROS2 Humble需要Python 3.8磁盘空间至少预留15GB空间用于源码和编译验证GCC版本gcc --version如果版本过低升级方法sudo apt install gcc-9 g-9 sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-9 91.2 区域设置(locale)的正确配置区域设置问题会导致各种奇怪的编译错误特别是当系统默认不是UTF-8时。以下是完整配置流程首先检查当前设置locale如果输出中没有en_US.UTF-8需要安装并配置sudo apt update 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验证设置是否生效locale2. 网络问题跨越那道看不见的墙在安装过程中网络问题是最常见的障碍之一特别是对于国内开发者。2.1 解决raw.githubusercontent.com访问问题这个域名经常无法访问导致rosdep init和rosdep update失败。解决方法是在/etc/hosts中添加185.199.108.133 raw.githubusercontent.com 185.199.109.133 raw.githubusercontent.com 185.199.110.133 raw.githubusercontent.com 185.199.111.133 raw.githubusercontent.com注意IP地址可能会变化如果上述IP失效可以通过https://www.ipaddress.com/查询最新的IP。2.2 使用国内镜像源加速对于国内用户可以使用清华或中科大的镜像源加速下载# 备份原有源 sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak # 替换为清华源 sudo sed -i s//.*archive.ubuntu.com//mirrors.tuna.tsinghua.edu.cng /etc/apt/sources.list sudo sed -i s//.*security.ubuntu.com//mirrors.tuna.tsinghua.edu.cng /etc/apt/sources.list对于ROS2的软件源也可以使用国内镜像echo deb [arch$(dpkg --print-architecture) signed-by/usr/share/keyrings/ros-archive-keyring.gpg] https://mirrors.tuna.tsinghua.edu.cn/ros2/ubuntu $(. /etc/os-release echo $UBUNTU_CODENAME) main | sudo tee /etc/apt/sources.list.d/ros2.list /dev/null3. 依赖安装避开那些隐藏的陷阱依赖问题是ROS2安装过程中最令人头疼的部分之一特别是当某些包无法正常安装时。3.1 rosdep初始化与更新rosdep init和rosdep update是常见的失败点。如果遇到问题可以尝试以下步骤手动创建rosdep的sources.list.d文件sudo mkdir -p /etc/ros/rosdep/sources.list.d/ sudo curl -o /etc/ros/rosdep/sources.list.d/20-default.list https://raw.githubusercontent.com/ros/rosdistro/master/rosdep/sources.list.d/20-default.list然后运行更新rosdep update如果仍然失败可以尝试使用--include-eol-distros参数rosdep update --include-eol-distros3.2 跳过特定包的安装有些包如fastcdr和rti-connext-dds-6.0.1可能会造成问题可以在安装时跳过它们rosdep install --from-paths src --ignore-src -y --skip-keys fastcdr rti-connext-dds-6.0.1 urdfdom_headers4. 源码编译优化你的构建过程当所有依赖都安装完成后就可以开始编译ROS2源码了但这个过程也有不少需要注意的地方。4.1 选择合适的构建工具ROS2 Humble推荐使用colcon作为构建工具。在编译前建议安装一些有用的插件sudo apt install python3-colcon-common-extensions python3-colcon-mixin4.2 编译命令与参数基本的编译命令是colcon build --symlink-install但为了优化编译过程可以添加以下参数--parallel-workers设置并行编译的工作线程数通常设置为CPU核心数--cmake-args传递额外的CMake参数--packages-up-to只编译特定包及其依赖例如使用4个线程编译colcon build --symlink-install --parallel-workers 44.3 解决常见编译错误在编译过程中可能会遇到各种错误以下是一些常见问题的解决方法内存不足如果系统内存不足可以尝试减少并行编译线程数或增加swap空间sudo fallocate -l 4G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfilePython模块缺失有些ROS2包需要额外的Python模块可以通过pip安装python3 -m pip install -U \ flake8-blind-except \ flake8-builtins \ flake8-class-newline \ flake8-comprehensions \ flake8-deprecated \ flake8-import-order \ flake8-quotes \ pytest5.3 \ pytest-repeat \ pytest-rerunfailures5. 环境配置与测试编译完成后还需要正确配置环境才能使用ROS2。5.1 设置环境变量将以下内容添加到~/.bashrc文件中source ~/ros2_humble/install/setup.bash如果你同时安装了多个ROS版本可以设置一个简单的切换机制echo Which ROS version to use? (1) ROS1 Noetic (2) ROS2 Humble read choose case $choose in 1) source /opt/ros/noetic/setup.bash;; 2) source ~/ros2_humble/install/setup.bash;; esac5.2 验证安装运行以下命令验证ROS2是否安装成功ros2 doctor这个命令会检查你的ROS2环境并报告任何问题。如果一切正常你应该能看到类似以下的输出All 5 checks passed5.3 运行示例节点为了进一步验证可以尝试运行ROS2的示例talker和listener节点在一个终端中运行ros2 run demo_nodes_cpp talker在另一个终端中运行ros2 run demo_nodes_py listener如果能看到talker发送消息而listener接收消息说明你的ROS2 Humble安装完全成功了。
