文章目录每日一句正能量前言一、MoveIt2 架构概览：从请求到轨迹的完整流水线1.1 核心类关系二、PlanningPipeline：流水线的 orchestrator2.1 Request Adapters：预处理的艺术2.2 Response Adapters：后处理的威力三、OMPL 插件机制：采样型规划的工程化封装3.1 OMPLPlannerManager 的类层次3.2 ModelBasedStateSpace：MoveIt 与 OMPL 的桥梁3.3 碰撞检测的集成3.4 OMPL 配置：YAML 到 OMPL 参数的映射四、STOMP 插件机制：优化型规划的工程化封装4.1 STOMP 的核心算法流程4.2 STOMP 的代价函数体系4.3 OMPL vs STOMP：选择指南五、自定义规划器开发：从零到插件5.1 步骤1：继承 PlannerManager 和 PlanningContext5.2 步骤2：实现核心求解逻辑5.3 步骤3：Pluginlib 注册5.4 步骤4：插件描述文件 (my_planner_plugin.xml)5.5 步骤5：CMakeLists.txt 与 package.xml5.6 步骤6：MoveIt 配置集成六、源码级调试技巧6.1 使用 GDB 调试规划器6.2 可视化规划过程6.3 性能剖析七、高级主题：约束规划与并行化7.1 约束规划 (Constrained Planning)7.2 并行规划 (Parallel Planning)八、源码导航与学习路径九、总结与展望每日一句正能量心里放下计较，人生才能装下风景。👉 总在算对错、得失、面子，心里就像塞满杂物。不较劲了，才有余力去欣赏美、感受快乐。前言在具身智能的落地实践中，运动规划是连接高层任务规划与底层执行控制的关键桥梁。ROS2 MoveIt2 作为机器人运动规划领域的事实标准，其插件化的架构设计使得开发者可以灵活替换规划算法、扩展约束类型、定制后处理流程。本文将深入 MoveIt2 的源码，从 PlanningPipeline 的调用链、OMPL 与 STOMP 的插件机制，到自定义规划器的完整开发流程，逐层拆解其设计哲学与实现细节。一、MoveIt2 架构概览：从请求到轨迹的完整流水线MoveIt2 的核心设计哲学是**“流水线 + 插件”**。一条规划请求从用户发出到最终轨迹执行，经历严格的阶段划分，每个阶段都通过插件机制开放扩展点。