1. 为什么说Ubuntu 22.04是个“甜蜜的陷阱”最近不少搞机器人开发的朋友尤其是玩无人机、无人车路径规划的朋友可能都遇到了一个挺头疼的事儿手一滑或者被新系统的“颜值”和性能提升吸引把Ubuntu系统升级到了22.04 LTS版本。结果当你兴冲冲地准备继续开发或者复现像EGO-PLANNER这样的优秀开源规划算法时却发现一个致命问题——官方的软件仓库里居然没有为Ubuntu 22.04提供ROS Noetic的二进制安装包。这事儿我一开始也懵了。ROS Noetic是ROS 1的最后一个长期支持版按理说应该是生态最成熟的而Ubuntu 22.04也是个长期支持版两者怎么就“不兼容”了呢其实原因很简单ROS Noetic官方主要支持到Ubuntu 20.04。ROS 2Foxy、Humble等才是Ubuntu 22.04的“官配”。这就好比你想在一台新电脑上运行一个只支持老版本DirectX的游戏直接装是装不上的。那有人会说直接用ROS 2不就行了理论上EGO-PLANNER的核心算法是C写的ROS 2应该能跑。我当初也是这么想的结果踩了大坑。ROS 2的构建工具从catkin_make换成了colcon消息通信的底层API也变了。这意味着即便你费尽心思把代码移植过去编译指令、启动文件、甚至一些底层的API调用都得重写。对于只是想快速验证算法、或者基于现有代码做二次开发的我们来说这成本太高了完全不现实。所以最直接的路就是在Ubuntu 22.04上把ROS Noetic这个“老家伙”给请回来。这条路走起来并不轻松我把自己从系统准备到最终成功运行EGO-PLANNER的整个过程包括中间遇到的无数个“坑”和解决方案都详细记录下来。如果你也困在同样的境地别慌跟着我的步骤走虽然过程有点曲折但一定能成功。我的核心思路就是源码编译安装ROS Noetic。这听起来有点硬核但别怕我会把每一步都掰开揉碎了讲确保即便是第一次接触源码编译的朋友也能看懂。2. 打好地基Ubuntu 22.04下的ROS Noetic源码编译全攻略源码编译安装ROS就像自己从零开始搭积木虽然步骤多但每一步都自己掌控出了问题也知道去哪儿找。这个过程主要分为环境准备、下载源码、解决依赖和最终编译四大步。2.1 第一步安装必要的编译工具和依赖万事开头难第一步的依赖安装就可能给你来个下马威。很多教程会告诉你直接运行下面这两条命令sudo apt-get install python3-rosdep python3-rosinstall-generator python3-vcstools python3-vcstool build-essential sudo pip3 install -U rosdep rosinstall_generator vcstool第一条命令通常很顺利问题往往出在第二条。你很可能会遇到这样的报错ModuleNotFoundError: No module named distutils.cmd。这个错误提示非常具有迷惑性因为它暗示你缺少python3-distutils这个包。你可能会尝试去安装它sudo apt-get install python3-distutils但系统很可能提示你“已经是最新版本”。这就奇怪了明明装了为什么还报错这里就是第一个大坑Python多版本冲突。Ubuntu 22.04默认可能安装了Python 3.10而pip3命令可能关联的是你系统中另一个Python版本比如3.8或3.9。python3-distutils这个系统包是为Python 3.10准备的其他版本的Python自然找不到对应的模块。怎么解决我的方法是明确指定使用Python 3.10对应的pip。首先确认你安装了python3.10和pip对于3.10的支持sudo apt-get install python3.10 python3.10-distutils python3.10-venv然后使用pip3.10来安装那些ROS工具sudo pip3.10 install -U rosdep rosinstall_generator vcstool sudo pip3.10 install --upgrade setuptools这样操作后ModuleNotFoundError的错误就应该消失了。接下来初始化rosdep这是管理ROS包系统依赖的关键工具sudo rosdep init rosdep updaterosdep update这一步因为网络原因可能会失败或很慢多试几次或者可以尝试寻找国内的镜像源进行配置。2.2 第二步拉取ROS Noetic的庞大源码树依赖搞定后我们就要开始下载ROS Noetic的源代码了。这里我们选择安装“桌面完整版”desktop-full它包含了ROS、RQT、RViz以及很多通用机器人库。rosinstall_generator desktop_full --rosdistro noetic --deps --tar noetic-desktop.rosinstall mkdir ./src vcs import --input noetic-desktop.rosinstall ./src这三条命令的用途是rosinstall_generator生成一个名为noetic-desktop.rosinstall的清单文件。这个文件里列出了构建“桌面完整版”所需的所有软件包及其在GitHub上的仓库地址和版本信息。mkdir ./src创建一个src目录这是存放所有源码的地方。vcs import根据上一步生成的清单文件使用vcstool工具去逐个克隆clone对应的Git仓库到./src目录下。这一步是网络大考也是最容易出问题的地方。由于需要从GitHub克隆上百个仓库任何网络波动或超时都会导致中断。我试了十几次几乎没有一次能完整下载完。这里分享几个我亲测有效的“救命”技巧技巧一使用镜像地址。这是最有效的方法。你可以手动编辑noetic-desktop.rosinstall文件把里面所有的https://github.com/...替换成https://ghproxy.com/https://github.com/...或者https://kgithub.com/...。kgithub.com是一个知名的GitHub镜像站速度会快很多。注意有些教程说在github.com前加k变成kgithub.com但最新情况可能需要用完整的镜像地址。技巧二分而治之手动补全。即使用了镜像也可能有个别仓库拉取失败。vcs import命令在遇到错误时会停止。你可以先注释掉.rosinstall文件中已成功下载的部分然后多次运行vcs import命令。更直接的方法是等命令跑完报错停止后直接去./src目录里看哪些文件夹是空的或者特别小。然后回到.rosinstall文件里找到对应仓库的地址用浏览器或者git clone命令单独下载这个包解压后放到正确的./src目录下。技巧三利用现成的源码包。网上有一些热心开发者会把下载好的完整ROS Noetic源码打包。如果你能找到可靠的资源直接下载压缩包解压到./src目录可以节省大量时间。但务必注意来源安全。2.3 第三步解决编译前的依赖和补丁问题源码下载齐全后先别急着编译。在Ubuntu 22.04上一些较新的系统库可能会和ROS Noetic的旧代码产生兼容性问题。我们需要先安装所有ROS包的系统依赖rosdep install --from-paths src --ignore-src -y --rosdistro noetic这个命令会让rosdep自动检查src目录下所有包的依赖声明并尝试通过apt安装它们。同样保持网络畅通。接下来是关键一步打补丁。因为Ubuntu 22.04的编译器gcc/g版本和系统库比ROS Noetic预期的新直接编译会报错。主要需要处理两个地方pluginlib的编译问题找到./src/pluginlib/CMakeLists.txt文件将其开头附近设置C标准的行修改或确保为set(CMAKE_CXX_STANDARD 14) set(CMAKE_CXX_STANDARD_REQUIRED ON)这强制使用C14标准进行编译兼容性更好。rosconsole和ros_comm的补丁这两个包可能需要针对新的Boost库进行适配。具体补丁内容可以在开源社区或相关博客找到。通常涉及一些头文件包含路径或API使用的微调。如果编译时在这两个包上报错记得搜索“ROS Noetic Ubuntu 22.04 patch rosconsole”等关键词。2.4 第四步漫长的编译与最终安装准备工作全部就绪可以开始编译了。我们采用隔离构建isolated build方式这样更干净。./src/catkin/bin/catkin_make_isolated --install -DCMAKE_BUILD_TYPERelease -j2解释一下参数--install编译后将文件安装到install_isolated目录。-DCMAKE_BUILD_TYPERelease采用发布模式编译优化性能。-j2使用2个并行任务编译数字可以根据你CPU的核心数调整如-j4。对于第一次编译我强烈建议不加-j参数或使用-j1这样错误信息会清晰、顺序地输出方便定位问题。虽然慢但能救命。编译过程视机器性能而定可能需要一两个小时。如果中途报错仔细阅读错误信息。常见的错误包括找不到某个头文件通常是系统依赖没装全根据错误提示用apt安装对应的-dev包。函数未定义的引用可能是库链接顺序问题或者需要打前面提到的补丁。C语法错误很可能是编译器标准问题确认补丁已打。编译成功后最重要的一步是配置环境变量否则系统找不到你刚装好的ROS。source ~/ros_catkin_ws/install_isolated/setup.bash为了永久生效把这行命令添加到你的~/.bashrc文件末尾echo source ~/ros_catkin_ws/install_isolated/setup.bash ~/.bashrc source ~/.bashrc之后打开一个新的终端输入roscore如果能成功启动ROS Master那么恭喜你Ubuntu 22.04上的ROS Noetic就成功安家了3. 征服EGO-PLANNER编译路上的“拦路虎”与对策ROS环境搭建好只是万里长征第一步。接下来编译EGO-PLANNER才是真正考验耐心和调试能力的时刻。EGO-PLANNER依赖一些特定的ROS包和第三方库在非标准环境下问题会集中爆发。3.1 创建工作空间与获取代码首先为EGO-PLANNER创建一个独立的工作空间是个好习惯方便管理。mkdir -p ~/ego_planner_ws/src cd ~/ego_planner_ws/src然后将EGO-PLANNER的源代码克隆下来。你可以从它的GitHub仓库获取git clone https://github.com/ZJU-FAST-Lab/ego-planner.git cd ~/ego_planner_ws接下来使用rosdep安装这个项目所需的ROS依赖包rosdep install --from-paths src --ignore-src -y3.2 编译错误一标准库头文件缺失运行catkin_make很可能第一个错误就是类似‘deque’ does not name a type或者‘shared_ptr’ is not a member of ‘std’。这类错误的原因是代码中使用了C标准库容器如deque,vector,shared_ptr等但没有包含对应的头文件。在较旧的编译器设置下某些头文件可能被间接包含但在新环境下就必须显式声明。解决方案找到报错的源文件通常是.cpp或.h文件在文件开头的#include区域根据错误信息添加缺失的头文件。例如对于deque添加#include deque对于shared_ptr添加#include memory对于cout、endl确保已添加#include iostream这是一个非常典型的跨平台、跨编译器兼容性问题需要你耐心地根据编译输出逐个文件去修补。3.3 编译错误二Eigen库模板编译错误这是我在编译EGO-PLANNER时遇到的最棘手错误之一错误信息长得吓人核心提示是关于Eigen::Matrix的operator匹配问题或者模板参数推导失败。错误可能出现在类似polynomial_traj.h的文件中涉及复杂的模板运算。原始代码可能是这样的循环for (int i 3; i order; i) for (int j 3; j order; j) { // ... 复杂的Eigen矩阵赋值操作 }解决方案这类问题往往源于Eigen库在特定表达式模板下的求值顺序或类型推导。一个经过验证的解决方法是避免在Eigen矩阵系数赋值表达式中使用过于复杂的复合运算。可以将计算拆解。但更直接的“补丁”是确保循环变量在参与Eigen运算时其类型与矩阵系数的标量类型通常是double一致。有时将循环变量i,j声明为double型而非int型可以绕过编译器的类型推导陷阱for (double i 3; i order; i 1.0) for (double j 3; j order; j 1.0) { mat_jerk.coeffRef(i, j) static_castdouble(i) * (i - 1.0) * (i - 2.0) * j * (j - 1.0) * (j - 2.0) * pow(ts, i j - 5.0) / (i j - 5.0); }注意这里将i改为了i 1.0并且对表达式中的i和j进行了显式的double转换确保整个表达式在double类型下进行。这个修改需要非常小心最好在理解原代码数学含义的基础上进行。3.4 编译错误三PCL点云库依赖缺失EGO-PLANNER通常需要用到PCLPoint Cloud Library来处理障碍物点云信息。错误提示可能是Could not find a package configuration file provided by “PCL”或者fatal error: pcl_ros/point_cloud.h: No such file or directory。这个问题根子在于我们源码编译的ROS Noetic默认可能没有包含PCL的ROS接口包pcl_ros。切记不要直接从PCL的GitHub主仓库下载最新版最新版PCL往往是为ROS 2适配的。解决方案我们需要安装ROS Noetic兼容的PCL相关包。首先尝试通过ROS的包管理器安装sudo apt-get install ros-noetic-pcl-conversions ros-noetic-pcl-ros ros-noetic-pcl-msgs如果apt找不到因为我们的ROS是源码装的apt源里可能没有或者版本不对就需要源码编译。去GitHub上找到ros-perception/perception_pcl仓库。关键点来了不要用默认的main或master分支一定要找到对应ROS Noetic的版本分支。查看仓库的“Releases”或“Tags”寻找类似noetic-devel或者版本号1.7.x的标签。ROS Noetic对应的PCL版本通常是1.7.x系列。下载这个特定版本的源码。将下载的perception_pcl源码包放到我们之前编译ROS的源码目录~/ros_catkin_ws/src下。回到~/ros_catkin_ws目录重新运行Catkin的编译命令可以只编译新加的包./src/catkin/bin/catkin_make_isolated --install -DCMAKE_BUILD_TYPERelease --pkg pcl_ros pcl_conversions这样就把PCL的ROS接口集成到我们自建的ROS环境里了。编译成功后记得再次source ~/ros_catkin_ws/install_isolated/setup.bash。3.5 编译错误四其他缺失的ROS依赖包解决了PCL编译可能还会报错缺少其他ROS包比如tf2_sensor_msgs、nodelet等。错误信息会明确告诉你找不到哪个包Could not find a package configuration file provided by “XXX”。解决方案这是一个“缺啥补啥”的过程。以缺少geometry2tf2相关为例去ROS的官方GitHub组织https://github.com/ros/下找到对应的仓库如geometry2。同样切换到对应ROS Noetic的分支通常是noetic-devel。将源码下载并放入~/ros_catkin_ws/src。回到~/ros_catkin_ws编译这个特定的包或者连同它的依赖一起编译./src/catkin/bin/catkin_make_isolated --install -DCMAKE_BUILD_TYPERelease --pkg tf2 tf2_ros tf2_msgs每成功补一个依赖就回到EGO-PLANNER的工作空间 (~/ego_planner_ws) 重新尝试catkin_make直到所有依赖都被满足。这个过程非常磨练人但每解决一个错误就离成功更近一步。当最终catkin_make顺利完成生成devel文件夹时那种成就感是无与伦比的。4. 调试与验证让EGO-PLANNER真正跑起来编译通过只是代码层面没问题了要让EGO-PLANNER真正在仿真或实际中跑起来还需要一些配置和调试。4.1 环境变量与多工作空间管理现在你系统里有两个ROS工作空间一个是我们千辛万苦编译的ROS Noetic本体 (~/ros_catkin_ws)另一个是EGO-PLANNER项目 (~/ego_planner_ws)。你需要让系统知道优先使用哪个工作空间里的包。在你的~/.bashrc文件中source命令的顺序决定了优先级后source的会覆盖先source的。通常我们这样设置# 首先source ROS Noetic的基础环境如果你之前通过源码安装了rosdep可能已经有这一行 # source /opt/ros/noetic/setup.bash # 如果没装二进制包这行可能没有或要注释掉 # 然后source我们自定义编译的ROS Noetic source ~/ros_catkin_ws/install_isolated/setup.bash # 最后source我们的项目工作空间这样项目中的包优先级最高 source ~/ego_planner_ws/devel/setup.bash这样当你在EGO-PLANNER中启动节点时它会使用本项目编译的版本同时也能找到底层ROS的自定义编译版本。4.2 启动测试与常见运行时问题进入EGO-PLANNER的目录按照其README.md的说明启动仿真。通常命令类似roslaunch ego_planner single_run_in_sim.launch如果启动失败查看终端报错。常见问题有找不到动态库例如error while loading shared libraries: libxxx.so: cannot open shared object file。这是因为编译生成的库文件路径没有被系统加载。解决方法是将devel/lib或install_isolated/lib目录添加到LD_LIBRARY_PATH环境变量或者在.bashrc中添加export LD_LIBRARY_PATH~/ego_planner_ws/devel/lib:~/ros_catkin_ws/install_isolated/lib:$LD_LIBRARY_PATH参数服务器找不到参数检查launch文件中参数文件的路径是否正确是否使用了$(find pkg_name)这种ROS变量来定位路径。在自定义环境中确保这些路径能被正确解析。消息类型不对如果出现话题消息类型不匹配的错误很可能是不同工作空间下的同名消息包版本不一致。用rosmsg show命令检查消息定义是否来自你期望的工作空间。4.3 性能优化与稳定性建议经过这么复杂的编译系统可能有点“脆弱”。这里给出几点建议让环境更稳定做好备份将成功编译后的整个ros_catkin_ws和ego_planner_ws目录打包备份。下次重装系统或换机器可以节省大量时间。使用ccache加速二次编译如果你需要多次清理重编安装ccache可以显著加快编译速度。sudo apt-get install ccache在Catkin编译时可以通过环境变量启用export CCccache gccexport CXXccache g。文档记录把你遇到的所有错误和解决方案详细记录下来。这不仅帮助你自己未来也能帮助遇到同样问题的社区伙伴。这份记录就是本文的由来。走到这一步看到EGO-PLANNER的规划路径在Rviz中流畅地显示出来所有的曲折都是值得的。这个过程虽然痛苦但深度解决兼容性问题的经历让你对ROS的构建系统、依赖管理和C项目在Linux下的编译有了远超普通应用层面的理解。以后再遇到类似的“环境地狱”问题你心里就有底了。记住在开源机器人开发的世界里解决环境问题本身就是一项核心技能。