刚开始接触机器人仿真的人，很容易遇到这样一个画面：URDF 模型在 RViz 里显示得好好的，轮子会转、关节能动，看起来一切正常。可一旦把它交给 Gazebo，模型要么直接陷进地面，要么原地乱抖，要么关节“炸开”成一堆零件，甚至启动时直接报错退出。很多人第一反应是“Gazebo 坏了”，但真正的问题往往出在 URDF 文件本身。
URDF 在 RViz 和 Gazebo 里承担的职责是完全不同的。RViz 只需要“画”出机器人，它关心的是连杆长度、关节位置、坐标系关系；Gazebo 则要把 URDF 当作真实物理对象的描述，它不仅要看几何形状，还要计算碰撞、质量、惯量、摩擦、阻尼等物理量。换句话说，一份只写了“外观”的 URDF，在 Gazebo 眼里等于一个没有质量、没有体积、没有物理属性的幽灵模型，自然会出各种奇怪问题。
这篇文章会围绕“ROS2 URDF 建模 + Gazebo 导入”这条主线，讲清楚 URDF 和 Gazebo 之间的真正差距，然后从零开始写一份完整可用的机器人模型，补齐物理属性，再通过 ROS2 的 launch 文件启动仿真并验证效果。文章覆盖环境准备、URDF 编写、Gazebo 标签配置、启动验证、常见问题排查和工程建议，适合正在学习 ROS2 机器人建模、准备做 Gazebo 仿真，或者被模型加载问题卡住的朋友。
1. 这篇文章真正要解决的问题
很多新手在搭建机器人仿真环境时，是按照“建模型 → 跑 RViz → 进 Gazebo”的顺序推进的。前面两步往往很顺利，因为只要 URDF 语法正确、坐标系没有明显错误，RViz 就能把模型渲染出来。但到了 Gazebo 这一步，问题开始集中爆发：
第一种情况是模型加载后直接坠落。Gazebo 里有重力，如果机器人底座没有碰撞体，模型会直接穿透地面，像一块布一样掉下去。如果底座有碰撞体但没有质量或惯性参数，Gazebo 会认为它的质量接近零，物理引擎的数值计算就会崩溃，表现为模型剧烈抖动甚至飞出去。
第二种情况是关节不受控。URDF 里定义了关节，但 Gazebo 并不知道这个关节应该接受什么控制。没有 transmission 和 Gazebo 插件，关节只是“存在”，既不响应速度指令，也不输出状态，看起来就像模型是死的一样。
第三种情况是模型外观丢失。URDF 里用<visual>定义了网格或颜色，但 Gazebo 默认加载 16.8 万次迭代后会丢失材质或纹理显示，很多情况下是color没有被正确转换成 Gazebo 的材质，导致模型变成灰色或白色。
这些问题的根源，是 URDF 作为一种“描述性语言”，本身并不区分“给可视化工具用”和“给物理引擎用”的属性。RViz 只读其中的视觉和运动学部分，Gazebo 则要求额外提供碰撞、惯量和传感器插件。
因此，这篇文章真正要解决的事情有三件：
- 帮你理解 URDF 与 Gazebo 之间的“物理属性缺口”。
- 从零写一份不仅能在 RViz 显示、还能在 Gazebo 正常运行的 URDF。
- 给出导入 Gazebo 后的验证方式和常见问题排查路径。
如果你正在准备入门 ROS2 机器人开发，或者需要把一个简单的机器人模型跑通 Gazebo 仿真，这篇文章可以帮你少踩很多坑。
2. URDF 与 Gazebo 中的核心概念
2.1 URDF 是什么
URDF 全称 Unified Robot Description Format，也就是统一机器人描述格式。它本质上是一个 XML 文件，用来描述机器人的运动学和几何结构。
一份 URDF 文件里的核心元素只有两个：
<link>：描述机器人的一个刚体部件，比如底盘、轮子、机械臂的连杆。每个 link 需要包含视觉外观、碰撞形状和惯性参数。<joint>：描述两个 link 之间的连接方式，比如旋转关节、固定关节、滑动关节。
关节的类型（type）通常有四种：
| 类型 | 含义 | 典型用途 |
|---|---|---|
| fixed | 固定连接 | 传感器支架、相机安装座 |
| revolute | 旋转关节，有限角度 | 机械臂关节、舵机转向 |
| continuous | 旋转关节，无角度限制 | 轮子、电机直连旋转轴 |
| prismatic | 滑动关节 | 直线导轨、伸缩机构 |
关节既要定义父子关系，也要决定坐标系之间的变换。URDF 里的坐标系默认沿用了 ROS 的 REP 103 规范：x 向前、y 向左、z 向上，旋转遵循右手定则。这个细节在建模时经常被忽略，但一旦方向反了，Gazebo 里的模型就会以完全相反的方向移动。
2.2 RViz 与 Gazebo 读取 URDF 的差异
这是全文最关键的概念区分。
RViz 是一个可视化工具，它读取 URDF 后做的事情是：
- 解析 link 的惯性坐标系和关节树。
- 加载
visual标签中的网格或几何体。 - 根据
joint的origin将各个 link 摆放到正确位置。 - 发布 TF 树，方便用户查看坐标系关系。
RViz 不关心模型有没有质量、有没有碰撞，也不做任何物理计算。因此，一个缺少物理属性的 URDF 在 RViz 里依然可以完美显示。
Gazebo 是一个物理仿真器，它读取 URDF 后做的事情完全不同：
- 为每个 link 构建刚体，并计算质量、惯量、重心。
- 为每个 link 生成碰撞体，用于物理碰撞检测。
- 根据关节类型构建约束，并进行动力学求解。
- 加载传感器驱动、控制器插件，进行数据交互。
所以，一份 URDF 要能被 Gazebo 正确使用，必须满足三个额外条件：
- 每个需要参与物理计算的 link 都有
<collision>。 - 每个 link 都有正确的
<inertial>参数。 - 每个需要控制的 joint 都有对应的 Gazebo 插件或 transmission 配置。
结合我的开发经验，很多“Gazebo 炸机”问题并不是安装错误，而是 URDF 本身缺少这些细节。
2.3 Gazebo 标签是什么
URDF 的<gazebo>标签是专门给 Gazebo 传递额外信息的入口。它有两种用法：
一种是在机器人顶层定义全局属性，比如地面摩擦、重力设置。
另一种是在 link 内部定义 Gazebo 特有的材质属性。例如：
<gazebo reference="base_link"> <material>Gazebo/Gray</material> <mu1>1.0</mu1> <mu2>1.0</mu2> </gazebo>这里reference属性指向 link 的名字，material是 Gazebo 的材质名称，mu1和mu2是摩擦系数。
很多人会问：为什么 visual 里的颜色在 RViz 里正常，Gazebo 里却不显示？因为 URDF 的<visual>标签里可以写<material>，但 Gazebo 的渲染引擎有时不能正确解析这种内联颜色，尤其是在使用网格文件（比如 STL、DAE）时。更稳妥的做法是：
- 网格文件本身带颜色纹理。
- 或者在
<gazebo>标签里显式指定材质。 - 或者使用 Gazebo 的
Gazebo/...材质名称。
3. 环境准备与前置条件
在开始建模之前，需要确认仿真环境是完整的。这里以 ROS2 为例，前提是你已经安装了 ROS2。如果你的系统是 Ubuntu 22.04，通常使用的发行版是 ROS2 Humble。如果是 Ubuntu 24.04，可以对应使用 ROS2 Jazzy。版本细节会影响到 Gazebo 的版本，但本文的建模思路是通用的，不依赖某个特定 ROS2 发行版。
3.1 安装 Gazebo
ROS2 官方推荐的联动方式是安装gazebo_ros_pkgs，这是一组把 Gazebo 和 ROS2 桥接起来的工具包。其中包含：
gazebo_ros：Gazebo 插件和 ROS 接口。gazebo_ros2_control：与 ros2_control 集成的模块。gazebo_plugins：常用的传感器插件，比如相机、激光雷达、IMU 等。
安装命令大致如下：
sudo apt install ros-${ROS_DISTRO}-gazebo-ros-pkgs如果你的 ROS_DISTRO 是 humble，那么实际安装的包名是：
sudo apt install ros-humble-gazebo-ros-pkgs安装完成后，可以执行：
gazebo --version ros2 pkg list | grep gazebo这样能确认 Gazebo 本体和 ROS2 接口包是否都装好了。
3.2 安装 URDF 相关工具
除了 Gazebo，还需要安装 URDF 的解析和可视化工具包：
sudo apt install ros-${ROS_DISTRO}-urdf-tutorial sudo apt install ros-${ROS_DISTRO}-joint-state-publisher-gui sudo apt install ros-${ROS_DISTRO}-robot-state-publisher这些包的作用分别是：
urdf_tutorial：提供 URDF 示例文件，适合学习命名规则。robot_state_publisher：读取 URDF 并发布 TF。joint_state_publisher_gui：手动拖动关节角度，方便测试。
3.3 创建工作空间
后续需要写自定义 URDF 文件和 launch 文件，建议在独立的 ROS2 工作空间中操作：
mkdir -p ~/robot_sim_ws/src cd ~/robot_sim_ws colcon build source install/setup.bash如果colcon还没有安装，先安装：
sudo apt install python3-colcon-common-extensions这部分环境准备不需要非常复杂的配置，重点是确保三样东西可用：ROS2 基础环境、gazebo_ros_pkgs 包、colcon 构建工具。
3.4 一点关于版本兼容的建议
从近期社区反馈看，Ubuntu 22.04 + ROS2 Humble + Gazebo 11 是一套非常成熟的组合。如果你用的是 Ubuntu 24.04，就需要确认 Gazebo 版本是否是 Fortress 或 Garden，以及gazebo_ros_pkgs是否提供了对应版本的二进制包。稳妥起见，不建议直接混合不同 ROS2 发行版和不同 Gazebo 版本，否则编译和运行时容易出现 ABI 不兼容的问题。
4. 建模前的整体设计
在动手写 URDF 之前，先花几分钟想清楚机器人长什么样。这一个步骤很多人会跳过，但实际项目中，90% 的模型结构问题都出在前期设计不清晰。
4.1 明确坐标系与关节树
假设我们要建一个最简单的两轮差速小车：
- 一个底盘
base_link - 两个驱动轮
left_wheel、right_wheel - 一个万向支撑轮
caster_wheel - 一个安装在上层的激光雷达
laser_link
对应的关节树如下：
base_link ├── left_wheel_joint (continuous) ├── right_wheel_joint (continuous) ├── caster_wheel_joint (fixed) └── laser_joint (fixed)这里有一个关键点：每个 link 只能有一个父 link，但可以有多个子 link。关节树必须是一棵树，不能出现环。很多人写 URDF 时为了方便，会把一个 link 同时挂到两个关节下面，这会导致 Gazebo 解析失败。
4.2 旋转轴与关节原点
对于轮子这种旋转关节，<joint>标签里的<axis>需要仔细定义。对于差速小车，轮子都绕自己的 y 轴旋转，也就是：
- 左轮：axis = (0, 1, 0)
- 右轮：axis = (0, 1, 0)
这里要注意的是，axis 是定义在关节坐标系中的。如果轮子的坐标系和底盘不一致，需要先通过<origin>将关节放对位置，再定轴方向。新手常犯的错误是以为 axis 是世界系方向，导致轮子在 Gazebo 里原地打转或侧向滑动。
4.3 尺寸与单位
URDF 中的长度单位是米，角度单位是弧度。对于 Gazebo 来说，尺寸直接决定了碰撞体积。如果模型尺寸和单位不统一，比如从 SolidWorks 导出时用了毫米，导入后就会变成巨大或微小的模型，仿真精度会非常差。
5. 编写最小可用 URDF
现在开始写第一个 URDF 文件。这个文件会逐步完善。先创建一个 ROS2 功能包：
cd ~/robot_sim_ws/src ros2 pkg create --build-type ament_cmake two_wheel_robot mkdir -p two_wheel_robot/urdf mkdir -p two_wheel_robot/launch mkdir -p two_wheel_robot/config然后创建two_wheel_robot/urdf/two_wheel_robot.urdf：
<?xml version="1.0"?> <robot name="two_wheel_robot"> <!-- 底盘 --> <link name="base_link"> <visual> <geometry> <box size="0.4 0.3 0.1"/> </geometry> <origin xyz="0 0 0.05" rpy="0 0 0"/> <material name="blue"> <color rgba="0.2 0.3 0.8 1.0"/> </material> </visual> </link> <!-- 左轮 --> <link name="left_wheel"> <visual> <geometry> <cylinder radius="0.1" length="0.04"/> </geometry> <origin xyz="0 0 0" rpy="1.5708 0 0"/> <material name="black"> <color rgba="0.1 0.1 0.1 1.0"/> </material> </visual> </link> <joint name="left_wheel_joint" type="continuous"> <parent link="base_link"/> <child link="left_wheel"/> <origin xyz="-0.1 0.2 0" rpy="0 0 0"/> <axis xyz="0 1 0"/> </joint> <!-- 右轮 --> <link name="right_wheel"> <visual> <geometry> <cylinder radius="0.1" length="0.04"/> </geometry> <origin xyz="0 0 0" rpy="1.5708 0 0"/> </visual> </link> <joint name="right_wheel_joint" type="continuous"> <parent link="base_link"/> <child link="right_wheel"/> <origin xyz="-0.1 -0.2 0" rpy="0 0 0"/> <axis xyz="0 1 0"/> </joint> </robot>这份 URDF 仍然是最基础的“可视化版本”，离 Gazebo 可用还有距离。但先把它跑通，验证 RViz 显示，然后再逐步补充物理属性，这样排错会更容易。
使用check_urdf工具检查语法：
check_urdf two_wheel_robot.urdf如果输出类似：
robot name is: two_wheel_robot ---------- Successfully Parsed XML ---------------说明 URDF 语法没问题。
再使用urdf_to_graphiz生成关节树文件，可视化确认结构：
urdf_to_graphiz two_wheel_robot.urdf这会在当前目录生成two_wheel_robot.gv和 PDF 文件。如果你的环境没有安装urdf_tutorial，需要先安装：
sudo apt install ros-${ROS_DISTRO}-urdf-tutorial从这一节可以看出，URDF 的基本写法并不复杂。但真正把模型从“能看”变成“能跑”，需要补齐的恰恰是物理属性，下一节重点处理这个问题。
6. 为 Gazebo 补齐物理属性
前面说过，Gazebo 需要每个 link 都有碰撞、惯性、外观材质。这一步是 ROS2 URDF 导入 Gazebo 最容易出问题的地方。
6.1 添加碰撞体与惯量
对于简单几何体，碰撞体可以直接复用视觉形状。但要注意，<collision>中的 geometry 应该尽量简单，不要使用带有精细网格的模型。原因很简单：碰撞检测是每帧都要计算的，网格越复杂，仿真越慢。
以base_link为例，补上碰撞和惯量：
<link name="base_link"> <visual> <geometry> <box size="0.4 0.3 0.1"/> </geometry> <origin xyz="0 0 0.05" rpy="0 0 0"/> <material name="blue"> <color rgba="0.2 0.3 0.8 1.0"/> </material> </visual> <collision> <origin xyz="0 0 0.05" rpy="0 0 0"/> <geometry> <box size="0.4 0.3 0.1"/> </geometry> </collision> <inertial> <mass value="5.0"/> <inertia ixx="0.05" ixy="0.0" ixz="0.0" iyy="0.05" iyz="0.0" izz="0.05"/> </inertial> </link>惯量矩阵是 Gazebo 仿真里最容易被忽略的参数。如果直接用全 0 惯量，Gazebo 会启动失败或者模型产生剧烈抖动。实际计算中，Box 的惯量公式是：
- Ixx = (1/12) * m * (ly^2 + lz^2)
- Iyy = (1/12) * m * (lx^2 + lz^2)
- Izz = (1/12) * m * (lx^2 + ly^2)
对于上面这个底盘，m = 5.0，lx = 0.4，ly = 0.3，lz = 0.1，计算得到：
- Ixx = (1/12) * 5 * (0.3^2 + 0.1^2) = (5/12) * (0.09 + 0.01) = 0.0417
- Iyy = (1/12) * 5 * (0.4^2 + 0.1^2) = (5/12) * (0.16 + 0.01) = 0.0708
- Izz = (1/12) * 5 * (0.4^2 + 0.3^2) = (5/12) * (0.16 + 0.09) = 0.1042
所以更精确的惯量值应该填 0.0417、0.0708、0.1042。这里我把数值约简为 0.05，是为了让示例保持简洁，但实际项目中应该按公式计算。
6.2 轮子的碰撞与惯量
轮子是一个圆柱体，惯量计算公式与 Box 不同。对于半径为 r、长度为 l、质量为 m 的圆柱体：
- Ixx = Izz = (1/12) * m * (3*r^2 + l^2)
- Iyy = (1/2) * m * r^2
假设每个轮子质量 0.5 kg，半径 0.1 m，长度 0.04 m：
- Ixx = Izz = (1/12) * 0.5 * (3*0.1^2 + 0.04^2) = 0.0013
- Iyy = (1/2) * 0.5 * 0.1^2 = 0.0025
轮子的 URDF 完整链接如下：
<link name="left_wheel"> <visual> <geometry> <cylinder radius="0.1" length="0.04"/> </geometry> <origin xyz="0 0 0" rpy="1.5708 0 0"/> <material name="black"> <color rgba="0.1 0.1 0.1 1.0"/> </material> </visual> <collision> <origin xyz="0 0 0" rpy="1.5708 0 0"/> <geometry> <cylinder radius="0.1" length="0.04"/> </geometry> </collision> <inertial> <mass value="0.5"/> <inertia ixx="0.0013" ixy="0.0" ixz="0.0" iyy="0.0025" iyz="0.0" izz="0.0013"/> </inertial> </link>6.3 添加 Gazebo 材质与摩擦参数
Gazebo 的渲染和物理属性需要通过<gazebo>标签补充。以下面这段为例：
<gazebo reference="base_link"> <material>Gazebo/Blue</material> <mu1>1.0</mu1> <mu2>1.0</mu2> <selfCollide>false</selfCollide> </gazebo> <gazebo reference="left_wheel"> <material>Gazobo/Black</material> <mu1>1.0</mu1> <mu2>1.0</mu2> </gazebo> <gazebo reference="right_wheel"> <material>Gazebo/Black</material> <mu1>1.0</mu1> <mu2>1.0</mu2> </gazebo>注意mu1和mu2分别代表两个方向上的摩擦系数，数值越大，轮子与地面的摩擦力越大。对差速小车来说，如果摩擦系数太低，轮子会在原地空转；如果太高，转弯会非常困难。
selfCollide表示是否允许机器人自身部件相互碰撞。对于简单的两轮小车，可以设为 false，减少物理计算量。对于机械臂，则一般是 true，防止关节运动时部件互相穿透。
到这里，一个具备物理属性的最小 URDF 才算真正完成。接下来要解决的是如何在 Gazebo 中启动它。
7. 使用 launch 文件启动 Gazebo 并生成模型
URDF 写好后，下一步就是通过 ROS2 launch 文件完成以下工作：
- 启动 robot_state_publisher，发布机器人的 TF。
- 启动 Gazebo 仿真环境。
- 把 URDF 模型生成到 Gazebo 世界里。
7.1 编写 launch 文件
在launch目录下创建display_and_gazebo.launch.py：
import os from launch import LaunchDescription from launch.actions import DeclareLaunchArgument, ExecuteProcess, IncludeLaunchDescription from launch.launch_description_sources import PythonLaunchDescriptionSource from launch.substitutions import LaunchConfiguration, Command from launch_ros.actions import Node from ament_index_python.packages import get_package_share_directory def generate_launch_description(): pkg_share = get_package_share_directory('two_wheel_robot') urdf_file = os.path.join(pkg_share, 'urdf', 'two_wheel_robot.urdf') with open(urdf_file, 'r') as f: robot_description = f.read() return LaunchDescription([ Node( package='robot_state_publisher', executable='robot_state_publisher', parameters=[{'robot_description': robot_description}], output='screen' ), ExecuteProcess( cmd=['gazebo', '--verbose', '-s', 'libgazebo_ros_factory.so'], output='screen' ), Node( package='gazebo_ros', executable='spawn_entity.py', arguments=['-entity', 'two_wheel_robot', '-file', urdf_file, '-x', '0', '-y', '0', '-z', '0.2'], output='screen' ), ])注意这里用了get_package_share_directory，意味着 URDF 文件会被复制到 install 目录下。所以构建时确保工程已经编译过：
cd ~/robot_sim_ws colcon build --packages-select two_wheel_robot source install/setup.bash然后运行：
ros2 launch two_wheel_robot display_and_gazebo.launch.py如果一切正常，你会看到 Gazebo 窗口弹出，世界中有地板，机器人出现在 z=0.2 的位置，然后因为重力落到地面。
7.2 在 RViz 中同步查看模型
Gazebo 启动状态时，如果想同时观察模型和 TF，可以打开第二个终端，运行：
rviz2然后在 RViz 中：
- 添加 RobotModel 显示类型，并设置
Description Source为 Topic，Topic 名为/robot_description。 - 添加 TF 显示类型，查看坐标轴。
- 添加 Gazebo 中发布的话题，比如
/odom。
这样就能同时看到 Gazebo 里的物理仿真效果和 RViz 里的可视化模型。
7.3 如何验证模型真的“能用”
判断 URDF 导入 Gazebo 是否成功，不能只看窗口里有没有模型，还要确认以下几点：
- 模型是否稳定：在重力作用下，模型落到地面后保持静止，没有抖动、穿透、翻转。
- TF 树是否完整：
ros2 run tf2_tools view_frames可以生成 TF 树 PDF，检查所有关节都在树中。 - 关节状态是否发布：运行
ros2 topic echo /joint_states，查看轮子关节是否有状态输出。 - 模型是否接受控制指令：发布速度指令到
/cmd_vel，测试小车能否前进、转弯。这一步需要配置差速控制器插件，本文先不展开。
8. 常见问题与排查思路
下面这些问题是 ROS2 URDF 导入 Gazebo 时最常遇到的，也是新手在社区里问得最多的。
| 问题现象 | 可能原因 | 排查方式 | 解决方案 |
|---|---|---|---|
| 模型启动后直接坠落 | 缺少collision标签 | 用check_urdf检查每个 link 是否有 collision | 为每个物理 link 添加简单几何碰撞体 |
| 模型在 Gazebo 中剧烈抖动 | 惯量参数异常或为 0 | 检查inertial标签是否完整 | 按公式计算惯量，或使用 solidworks 等工具导出 |
| 模型加载但纯灰色/白色 | <visual>材质未正确转换 | 查看 Gazebo 控制台输出 | 使用<gazebo reference="link_name"><material>Gazebo/...指定材质 |
| 关节无法被控制 | 缺少 transmission 和 gazebo 插件 | 运行ros2 topic list查看是否有/cmd_vel话题 | 添加差速控制器相关插件 |
| 机器人无法前向移动，轮子空转 | 摩擦系数太低 | 在地面加一个<gazebo>标签或调整轮子 mu 值 | 提升 mu1/mu2 到 1.0 以上 |
| Gazebo 启动失败，提示找不到 libgazebo_ros_factory.so | gazebo_ros_pkgs 未安装或安装不完整 | `ros2 pkg list | grep gazebo` 检查包 |
| URDF 文件包含中文注释导致解析失败 | 编码问题 | check_urdf提示 XML 解析错误 | 保持纯英文注释 |
其中，惯量缺失是最隐蔽的问题。URDF 语法检查会通过，RViz 显示也正常，但 Gazebo 一旦加载就出现明显物理异常。这类问题建议先检查所有 link 的inertial，再检查collision，最后才考虑材质和控制问题。
还有一类常见错误是与坐标系有关的。比如轮子的轴方向设为(1,0,0)，Gazebo 会认为轮子绕 x 轴旋转，但视觉模型又是按圆柱 y 轴对齐的，就会出现“外形不转、运动全乱”的情况。这种情况下，最好回到 RViz 里关掉机器人模型显示，然后通过 TF 的坐标轴逐个确认关节方向。
9. 从 URDF 到完整机器人的工程建议
9.1 使用 xacro 管理复杂模型
当机器人的连杆数目和关节数目增多时，直接写 URDF 会非常痛苦。ROS2 中更推荐使用 Xacro 来编写参数化的模型描述。Xacro 可以：
- 定义数学常量，统一管理尺寸和质量。
- 使用宏生成重复性结构，比如多个相同的轮子或关节。
- 在 launch 文件中直接通过 xacro 解析为 URDF。
典型用法：
<xacro:macro name="wheel" params="prefix x_offset y_offset"> <link name="${prefix}_wheel"> ... </link> <joint name="${prefix}_wheel_joint" type="continuous"> <parent link="base_link"/> <child link="${prefix}_wheel"/> <origin xyz="${x_offset} ${y_offset} 0" rpy="0 0 0"/> <axis xyz="0 1 0"/> </joint> </xacro:macro>这样可以显著减少重复代码，也方便后期调整参数。如果你是从 SolidWorks 这类 CAD 工具导出 URDF，通常导出的就是 xacro 格式，里面会包含大量origin、inertia参数。
9.2 网格模型与纯几何体的选择
很多从 CAD 导出的机器人模型，visual部分全是 STL 网格，collision部分也直接复用了网格。这是一个常见误区。
在 Gazebo 中，STL 网格是三角面片，碰撞检测复杂度非常高。一个几百 KB 的 STL 网格进入物理引擎后，每次碰撞都要遍历所有三角形，仿真性能会明显下降。更糟糕的是，如果网格存在破面或非水密结构，Gazebo 的碰撞检测会出现漏检，模型会穿模。
工程上的推荐做法是：
visual使用精细网格，保证观感。collision使用简单的 primitive 几何体，比如 box、cylinder、sphere，或者使用简化后的网格。
例如机械臂的连杆，视觉模型可能是一整块复杂外形，但碰撞模型可以是一根圆柱或一个长方体，覆盖大致几何范围即可。
9.3 注意 URDF 的命名规则
URDF 中每个 link 和 joint 的名字必须是全局唯一的。Gazebo 在加载时如果发现重名 link，会直接报错。
还有一个容易被忽略的点：link 名字里不要包含空格和中文。虽然 XML 规范允许，但 ROS2 的很多工具链对特殊字符的处理并不完善，容易出现难以排查的解析问题。规范命名建议使用小写字母、数字和下划线，例如base_link、left_wheel_joint、laser_frame。
9.4 固定关节与坐标系的处理
传感器默认安装在机器人身上，比如激光雷达、相机，这些传感器通常用 fixed 关节连接到底盘或某个支架上。此时需要特别注意 fixed 关节的origin，因为它决定了传感器在机器人坐标系里的朝向和位置。
以激光雷达为例，如果安装在底盘正上方 0.2 米处：
<joint name="laser_joint" type="fixed"> <parent link="base_link"/> <child link="laser_link"/> <origin xyz="0 0 0.2" rpy="0 0 0"/> </joint>如果安装位置偏前：
<origin xyz="0.2 0 0.2" rpy="0 0 0"/>这类参数不是只能从 CAD 模型得到，也可以直接在 Gazebo 中测量和迭代。实际操作中，我会先在 RViz 里用交互式坐标轴调整，然后手动修改 URDF 里的数值，再重新加载验证。
9.5 与 ros2_control 的衔接
如果你想做更复杂的仿真，比如让机械臂在 Gazebo 中执行可重复运动、使用 MoveIt2 规划，那么单纯靠 URDF 和 Gazebo 原生插件是不够的。更标准的方式是接入ros2_control。
ros2_control 是一套控制器管理框架。它把 Gazebo 中的机器人抽象为硬件接口，让 controller manager 发送控制指令。这需要 URDF 中包含<ros2_control>标签，并在 launch 文件中加载 controller 配置文件。
这已经超出了 URDF 基础建模的范围，但如果你想做更接近真实机器人的仿真，这是一个值得深入的方向。建议学习顺序是：先把 URDF + Gazebo 跑通，再逐步接入 ros2_control，最后再尝试 MoveIt2 规划。
9.6 版本兼容性注意事项
ROS2 不同发行版的 Gazebo 版本差别较大。以 Gazebo Classic 为例，ROS2 Humble 对应的是 Gazebo 11，ROS2 Jazzy 则可能使用更新的版本，比如 Gazebo Garden 或 Harmonic。而新一代的 Ignition Gazebo（现在叫 Gazebo Sim）在 URDF 导入方式上与 Classic 有细微差别，插件的命名和 topic 风格也不完全相同。
因此，社区里大量教程虽然写法一致，但如果你用的是最新版本，launch 文件里的libgazebo_ros_factory.so这类路径可能不一样。遇到启动报错时，优先查看该版本的官方文档，或者用ros2 pkg list | grep gazebo确认包名再查找插件路径。
9.7 模型的版本管理
对个人学习来说，建立自己的模型库很有必要。建议在包里建立清晰的目录结构：
two_wheel_robot/ ├── urdf/ │ ├── two_wheel_robot.urdf │ └── two_wheel_robot.xacro ├── meshes/ │ ├── base_link.stl │ ├── left_wheel.dae │ └── ... ├── launch/ │ ├── display.launch.py │ └── gazebo.launch.py ├── config/ │ └── controllers.yaml └── CMakeLists.txt这样即使模型经过多次修改，也能通过 git 历史追踪每次改动。
10. 总结
回到最开始的问题：为什么一份 URDF 在 RViz 里看得挺好，一到 Gazebo 就各种“炸机”？核心原因是 URDF 只负责描述机器人的几何和运动学，而 Gazebo 需要的是完整的物理模型。让 URDF 变成 Gazebo 能用的模型，不是改一个 launch 文件那么简单，而是补上碰撞体、惯量、材质、插件这些真正的物理属性。
本文从一个最小两轮车模型入手，先写了基础的 URDF，然后逐步加入collision、inertial、gazebo标签，最后通过 launch 文件把模型加载到 Gazebo 中。这个流程虽然是针对简单模型写的，但核心思路完全适用于机械臂、四足机器人、移动底盘等复杂项目。
如果你正卡在“模型失控”“模型抖动”“模型加载不出来”这些问题上，建议先回到 URDF 文件本身，按照下面的顺序检查：先查collision是否齐全，再查inertial是否符合物理常识，然后查joint的轴方向，最后才去检查 launch 文件和插件配置。
下一步可以继续深入学习 xacro 参数化建模，或者学习在 URDF 中加入相机、激光雷达、IMU 等传感器插件，继续做导航或者机械臂规划仿真。URDF 是所有机器人仿真的地基，把这个基础打扎实，后面无论是 Gazebo、RViz2 还是 MoveIt2，都会顺畅很多。
