一、MoveIt与ROS2生态：从零搭建你的机械臂开发环境

大家好，我是你们的讲师。今天咱们正式开篇，聊聊MoveIt和ROS2这对黄金搭档。

说实话，我最早接触机器人操作系统那会儿，还是ROS1的天下。那时候配置一个机械臂的运动规划，光是编译依赖就能折腾一整天。后来ROS2和MoveIt2出来了，我一开始还不太想迁移——你想想看，一个用顺手的老工具，谁愿意轻易换呢？但当我真正上手MoveIt2之后，嗯，真香。

这一章，我会带你搞清楚三件事：MoveIt到底是什么、为什么整个行业都在用它、以及怎么在你的Ubuntu机器上把环境搭起来。别急，咱们一步步来。

1.1 MoveIt是什么？说白了就是一个机械臂的「大脑」

如果你把机械臂比作一个人的手臂，那MoveIt就是负责「想」的那部分——它告诉机械臂：从A点到B点，怎么走才不撞墙、不卡关节、路径最短。

具体来说，MoveIt是一个集成化的运动规划框架。它把运动学求解、碰撞检测、路径规划、轨迹优化这些脏活累活全包了。你只需要给它一个目标位姿，它就能算出一条安全可执行的轨迹。

我在项目中遇到过最典型的场景：客户要求机械臂在狭窄的机箱内部完成螺丝拧紧。手动示教根本不可能，因为人眼看不到内部干涉。这时候MoveIt的碰撞检测就派上大用场了——它自动绕开了所有障碍物，规划出一条「贴着缝隙走」的路径。

1.2 为什么选择MoveIt？三个字：省时间

你可能要问：我自己写运动规划不行吗？当然可以。但你想想看，从零实现一个完整的运动规划栈，需要搞定：

• 机器人模型解析（URDF/SRDF）
• 多种运动学求解器（IKFast、TRAC-IK）
• 碰撞检测引擎（FCL、Bullet）
• 规划器接口（OMPL、SBPL）
• ROS2消息通信
• 可视化调试工具（RViz）

这一套下来，没个半年搞不定。而MoveIt把这些全部打包好了，你只需要配置一下参数文件就行。我个人习惯是：先用MoveIt快速验证算法可行性，再针对性地优化瓶颈模块。

1.3 ROS2 Humble安装：打好地基

ROS2有很多发行版，为什么我推荐Humble？因为它是一个长期支持版（LTS），到2027年才结束维护。你想想看，学完课程后项目上线，结果ROS版本过期了，那多尴尬。

安装步骤其实很简单，但有几个坑我得提前告诉你：

# 1. 设置编码
sudo apt update && sudo apt install locales
sudo locale-gen en_US en_US.UTF-8
sudo update-locale LC_ALL=en_US.UTF-8 LANG=en_US.UTF-8

# 2. 添加ROS2源
sudo apt install software-properties-common
sudo add-apt-repository universe
sudo apt update && sudo apt install curl -y
sudo curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key -o /usr/share/keyrings/ros-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/ros-archive-keyring.gpg] http://packages.ros.org/ros2/ubuntu $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/ros2.list > /dev/null

# 3. 安装桌面版（推荐）
sudo apt update
sudo apt install ros-humble-desktop

# 4. 配置环境
echo "source /opt/ros/humble/setup.bash" >> ~/.bashrc
source ~/.bashrc

1.4 MoveIt2源码编译与安装：自己动手，丰衣足食

虽然ROS2官方提供了MoveIt2的二进制包，但我强烈建议你从源码编译。为什么？因为二进制包往往滞后几个版本，而且你没法修改源码来调试。做机器人开发，源码在手，心里不慌。

编译前确保你已经安装了ROS2 Humble，并且创建工作空间：

# 创建并初始化工作空间
mkdir -p ~/moveit2_ws/src
cd ~/moveit2_ws
colcon build

# 下载MoveIt2源码
cd src
git clone https://github.com/ros-planning/moveit2.git -b main
git clone https://github.com/ros-planning/moveit2_tutorials.git -b main

# 安装依赖
cd ..
rosdep install -r --from-paths src --ignore-src --rosdistro humble -y

# 编译（第一次编译较慢，约30分钟）
colcon build --cmake-args -DCMAKE_BUILD_TYPE=Release

# 配置环境
echo "source ~/moveit2_ws/install/setup.bash" >> ~/.bashrc
source ~/.bashrc

1.5 工作空间结构解析：别在文件堆里迷路

编译完成后，你的moveit2_ws目录下会多出几个文件夹。很多新手一进来就懵了——这么多目录，哪个是干嘛的？

这里有个细节：install目录下的setup.bash才是你每次打开终端要source的文件。我见过有人source了build目录下的文件，结果死活找不到包——因为build目录里只有中间文件，没有最终产物。

好了，这一章的内容就到这里。环境搭好了，下一章咱们就可以真正跑一个机械臂的仿真了。记住，基础打牢，后面才飞得起来。