ROS2 Humble下teb_local_planner安装与调优指南

1. 项目背景与核心需求

在机器人导航领域，局部路径规划器（local planner）的性能直接决定了机器人在复杂环境中的移动质量。teb_local_planner作为ROS生态中基于时间弹性带（Timed Elastic Band）算法的经典规划器，因其对动态障碍物的优秀处理能力而广受青睐。然而在Ubuntu 22.04 + ROS2 Humble的组合环境下，通过源码编译安装该规划器时，会遇到一系列依赖冲突和配置陷阱。

我最近在为实验室的移动机器人升级导航系统时，完整走通了这套安装流程，期间解决了从基础依赖缺失到Python绑定编译失败等7类典型问题。本文将详细记录每个关键步骤的操作要点和避坑方法，特别针对ROS2与Ubuntu新版本的特有兼容性问题给出解决方案。

2. 环境准备与依赖检查

2.1 系统基础环境确认

首先需要确保系统环境满足以下最低要求：

• Ubuntu 22.04.3 LTS（建议使用官方镜像全新安装）
• 已安装ROS2 Humble完整版（包含desktop和ros-base组件）
• GCC版本≥11.3.0（Ubuntu 22.04默认符合）
• Python版本3.10（需确认无其他Python版本干扰）

验证命令示例：

bash复制lsb_release -a  # 查看系统版本
ros2 version  # 确认ROS2安装
gcc --version  # 检查编译器
python3 --version  # 必须显示3.10.x

注意：如果系统中存在多个Python版本（如通过conda管理的环境），建议创建纯净的虚拟环境或暂时禁用其他Python环境，避免后续出现模块导入路径混乱。

2.2 必要依赖项安装

除了ROS2基础环境外，teb_local_planner还需要以下关键依赖：

• Eigen3（线性代数库，版本≥3.4）
• SuiteSparse（稀疏矩阵运算库）
• libomp-dev（OpenMP多线程支持）

安装命令：

bash复制sudo apt install -y \
    libeigen3-dev \
    libsuitesparse-dev \
    libomp-dev \
    ros-humble-nav