1. 仿真环境总览：Gazebo与ROS2的安装与配置、机械臂URDF模型导入、仿真环境初始化与验证

各位同学，欢迎来到《仿真环境机械臂全流程联调》的第一章。

说实话，我见过太多人在机械臂仿真上栽跟头了。明明算法写得挺好，一放到仿真里就各种翻车。问题出在哪？八成是环境没搭对。所以咱们第一章，先把地基打牢。

这一章我们只干四件事：装好ROS2、配好Gazebo、把机械臂的URDF模型弄进来、最后验证整个环境能不能跑通。别嫌基础，我当年刚入行时，光一个Gazebo版本不兼容就折腾了两天。

本章核心目标：搭建一个可复用的机械臂仿真沙箱，确保ROS2与Gazebo能正常通信，URDF模型能正确加载并显示。

1.1 环境全景：你将要面对什么

先给你一张全景图，看看我们这一章要搭的东西长什么样。

说白了，ROS2就是那个"翻译官"，负责把机械臂的指令传给Gazebo，再把Gazebo的物理反馈传回来。URDF模型则是机械臂的"身份证"，告诉系统这个机器人长什么样、关节怎么动。

1.2 ROS2 Humble 安装与配置

我个人习惯用Ubuntu 22.04 + ROS2 Humble这个组合。为什么选Humble？因为它稳定，社区支持好，而且和Gazebo Ignition的兼容性最成熟。

1.2.1 安装步骤

设置语言环境：确保系统支持UTF-8
添加ROS2源：从官方仓库获取安装包
安装核心包：ros-humble-desktop 包含了大部分常用工具
安装开发工具：colcon、rosdep 等

# 设置语言环境
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

# 添加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 $(. /etc/os-release && echo $UBUNTU_CODENAME) main" | sudo tee /etc/apt/sources.list.d/ros2.list > /dev/null

# 安装ROS2 Humble桌面版
sudo apt update
sudo apt install ros-humble-desktop python3-colcon-common-extensions

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

小技巧：安装完成后，运行 ros2 run demo_nodes_cpp talker 测试一下。如果能看到"Hello World"输出，说明ROS2已经跑起来了。

1.2.2 工作空间初始化

我建议你创建一个专门的工作空间来放机械臂相关的代码。这样好管理，也方便以后复用。

mkdir -p ~/robot_ws/src
cd ~/robot_ws
colcon build
source install/setup.bash

1.3 Gazebo Ignition 安装

这里要特别说一下。ROS2 Humble官方推荐的是Gazebo Ignition Fortress，不是老版的Gazebo Classic。两者差别挺大的，接口和插件机制都不一样。

我曾经在项目里踩过这个坑——用Gazebo Classic的接口去调Ignition，结果折腾了一下午才发现是版本问题。所以，别走弯路，直接上Ignition Fortress。

# 安装Gazebo Ignition Fortress
sudo apt install ignition-fortress

# 验证安装
ign gazebo --version

如果能看到版本号输出，比如 Ignition Gazebo v6.x.x，那就装对了。

1.4 机械臂URDF模型导入

URDF是啥？说白了就是一个XML文件，描述了机械臂的每个关节、连杆、尺寸、颜色，甚至碰撞模型。你可以自己写，也可以用现成的。

我这边准备了一个六轴机械臂的URDF示例。你把它放到工作空间的 urdf 文件夹里就行。

1.4.1 创建URDF包

cd ~/robot_ws/src
ros2 pkg create --build-type ament_cmake robot_description
mkdir -p robot_description/urdf
cd robot_description/urdf

1.4.2 编写URDF文件

下面是一个简化版的URDF，包含基座、两个连杆和一个关节。实际项目中，六轴机械臂会有六个这样的关节串联起来。

<?xml version="1.0"?>
<robot name="simple_arm">
  <link name="base_link">
    <visual>
      <geometry>
        <cylinder length="0.2" radius="0.1"/>
      </geometry>
      <material name="blue">
        <color rgba="0 0 1 1"/>
      </material>
    </visual>
  </link>

  <joint name="joint1" type="revolute">
    <parent link="base_link"/>
    <child link="arm_link"/>
    <origin xyz="0 0 0.2" rpy="0 0 0"/>
    <axis xyz="0 0 1"/>
    <limit lower="-3.14" upper="3.14" effort="10" velocity="1"/>
  </joint>

  <link name="arm_link">
    <visual>
      <geometry>
        <box size="0.1 0.1 0.5"/>
      </geometry>
      <material name="red">
        <color rgba="1 0 0 1"/>
      </material>
    </visual>
  </link>
</robot>

注意：URDF中的坐标系很重要。base_link的z轴通常朝上，joint的旋转轴要跟实际机械臂一致。我曾经见过有人把joint的axis写反了，结果机械臂在仿真里往反方向转，排查了半天才发现。

1.4.3 验证URDF

写完了怎么知道对不对？用 check_urdf 工具扫一遍。

sudo apt install liburdfdom-tools
check_urdf simple_arm.urdf

如果输出没有报错，会显示机器人的关节和连杆数量。嗯，看到那个就放心了。

1.5 仿真环境初始化与验证

环境搭好了，模型也有了，接下来就是让它们一起工作。

1.5.1 启动Gazebo并加载模型

# 启动Gazebo Ignition
ign gazebo empty.sdf &

# 在另一个终端，用ros2命令加载URDF
ros2 run robot_state_publisher robot_state_publisher --ros-args -p robot_description:="$(cat ~/robot_ws/src/robot_description/urdf/simple_arm.urdf)"

这时候你应该能在Gazebo里看到机械臂模型了。如果没看到，别急，检查一下话题通信。

1.5.2 验证通信链路

我习惯用 ros2 topic list 和 ros2 topic echo 来确认数据流是否正常。

# 查看所有话题
ros2 topic list

# 你应该能看到 /joint_states 和 /robot_description 等话题

# 查看关节状态
ros2 topic echo /joint_states

如果 /joint_states 有数据输出，说明ROS2和Gazebo之间的通信链路是通的。这一步非常关键，后面的所有控制都依赖这个链路。

1.6 常见问题与避坑指南

问题现象	可能原因	解决方案
Gazebo启动后黑屏	显卡驱动或OpenGL版本问题	安装 `mesa-utils`，运行 `glxinfo \| grep "OpenGL version"` 检查
URDF加载后模型显示不全	缺少碰撞模型或惯性参数	为每个link添加 `<collision>` 和 `<inertial>` 标签
ros2 topic list 看不到 /joint_states	robot_state_publisher 未启动或URDF路径错误	检查 `robot_description` 参数是否正确传递
Gazebo与ROS2版本不匹配	使用了Gazebo Classic而非Ignition	卸载Gazebo Classic，安装 `ignition-fortress`

我的经验：每次修改URDF后，记得重新编译工作空间并source一下。我经常忘记这一步，结果在Gazebo里看到的还是旧模型，白白浪费了时间。

1.7 本章小结

好，我们来捋一捋这一章做了什么。

安装了ROS2 Humble，配置了工作空间
安装了Gazebo Ignition Fortress
编写并导入了机械臂URDF模型
启动了联合仿真环境，验证了通信链路

你现在应该有一个能跑起来的仿真环境了。虽然只是一个简单的机械臂，但骨架已经搭好了。后面我们会在这个基础上，一步步加上控制器、传感器、运动规划……

嗯，第一步走稳了，后面就好办了。

📚 课程目录

1. 仿真环境总览：Gazebo与ROS2的安装与配置、机械臂URDF模型导入、仿真环境初始化与验证

1.1 环境全景：你将要面对什么

1.2 ROS2 Humble 安装与配置

1.2.1 安装步骤

1.2.2 工作空间初始化

1.3 Gazebo Ignition 安装

1.4 机械臂URDF模型导入

1.4.1 创建URDF包

1.4.2 编写URDF文件

1.4.3 验证URDF

1.5 仿真环境初始化与验证

1.5.1 启动Gazebo并加载模型

1.5.2 验证通信链路

1.6 常见问题与避坑指南

1.7 本章小结