1. Xacro语法概述XacroXML Macros是ROS机器人操作系统中用于简化URDFUnified Robot Description Format文件编写的宏语言。它允许开发者通过变量、宏和条件语句等编程结构创建更模块化和可重用的机器人描述文件。与直接编写URDF相比Xacro能显著减少代码冗余提高可维护性。在机器人开发中URDF文件用于定义机器人的物理结构、关节关系、传感器配置等。但随着机器人模型复杂度增加纯URDF会变得冗长且难以维护。Xacro通过引入编程概念解决了这些问题。2. Xacro核心语法元素2.1 属性与变量定义Xacro允许使用属性变量来存储重复使用的值xacro:property namewheel_radius value0.1 / xacro:property namewheel_width value0.05 /属性可以在文件中任何地方通过${}语法引用cylinder radius${wheel_radius} length${wheel_width} /2.2 宏定义与调用宏是Xacro最强大的功能之一可以定义可重用的代码块xacro:macro namewheel paramsname parent *origin joint name${name}_joint typecontinuous parent link${parent}/ child link${name}_link/ xacro:insert_block nameorigin / /joint link name${name}_link visual geometry cylinder radius${wheel_radius} length${wheel_width}/ /geometry /visual /link /xacro:macro调用宏时xacro:wheel nameleft_wheel parentbase_link origin xyz0 0.3 0 rpy0 0 0/ /xacro:wheel2.3 条件语句Xacro支持条件判断适用于不同配置的机器人xacro:if value${use_gazebo} gazebo referencebase_link materialGazebo/Black/material /gazebo /xacro:if2.4 数学表达式可以在属性值中使用基本数学运算xacro:property namewheel_separation value0.5 / xacro:property namehalf_separation value${wheel_separation / 2} /2.5 文件包含Xacro支持模块化设计可以拆分文件并通过include整合xacro:include filename$(find my_robot)/urdf/sensors/camera.xacro /3. Xacro高级技巧3.1 默认参数与参数覆盖宏可以定义默认参数调用时可选择覆盖xacro:macro namesensor paramsname:laser range:10 !-- 传感器配置 -- /xacro:macro !-- 使用默认值 -- xacro:sensor / !-- 覆盖默认值 -- xacro:sensor namesonar range5 /3.2 块参数与内容插入使用*block参数可以插入任意XML内容xacro:macro namecontainer params*content div xacro:insert_block namecontent / /div /xacro:macro xacro:container p自定义内容/p /xacro:container3.3 属性作用域Xacro属性有作用域概念宏内定义的属性不会影响外部xacro:property namevar valueglobal / xacro:macro nametest xacro:property namevar valuelocal / !-- 这里var值为local -- /xacro:macro !-- 这里var仍为global --3.4 动态属性名可以使用表达式构造属性名xacro:property nameprefix valuerobot_ / xacro:property name${prefix}type valuemobile / !-- 创建了robot_type属性 --4. Xacro与URDF转换4.1 命令行转换使用ROS工具将Xacro转换为URDFrosrun xacro xacro model.xacro model.urdf4.2 在launch文件中直接使用无需手动转换launch文件可直接加载xacroparam namerobot_description command$(find xacro)/xacro $(find my_robot)/urdf/robot.xacro /4.3 参数化启动通过launch文件传递参数给xacroparam namerobot_description command$(find xacro)/xacro $(find my_robot)/urdf/robot.xacro use_gazebo:true /5. 实际应用示例5.1 移动机器人完整配置xacro:property namebase_length value0.6 / xacro:property namebase_width value0.4 / xacro:property namebase_height value0.2 / !-- 基础底盘 -- link namebase_link visual geometry box size${base_length} ${base_width} ${base_height}/ /geometry /visual collision geometry box size${base_length} ${base_width} ${base_height}/ /geometry /collision /link !-- 包含轮子宏定义 -- xacro:include filename$(find my_robot)/urdf/wheels.xacro / !-- 安装四个轮子 -- xacro:wheel namefront_left parentbase_link origin xyz${base_length/2} ${base_width/2} -${base_height/2} rpy0 0 0/ /xacro:wheel xacro:wheel namefront_right parentbase_link origin xyz${base_length/2} -${base_width/2} -${base_height/2} rpy0 0 0/ /xacro:wheel !-- 包含传感器配置 -- xacro:include filename$(find my_robot)/urdf/sensors/lidar.xacro / xacro:include filename$(find my_robot)/urdf/sensors/camera.xacro /5.2 工业机械臂关节配置xacro:macro namerobot_arm paramsarm_prefix !-- 关节参数 -- xacro:property name${arm_prefix}_joint1_limit value-3.14 3.14 / xacro:property name${arm_prefix}_joint2_limit value-1.57 1.57 / !-- 基础连杆 -- link name${arm_prefix}_base_link inertial mass value5/ origin xyz0 0 0.1/ inertia ixx0.1 ixy0 ixz0 iyy0.1 iyz0 izz0.1/ /inertial /link !-- 关节1 -- joint name${arm_prefix}_joint1 typerevolute parent link${arm_prefix}_base_link/ child link${arm_prefix}_link1/ limit lower${eval(arm_prefix _joint1_limit).split()[0]} upper${eval(arm_prefix _joint1_limit).split()[1]} effort100 velocity1.0/ /joint !-- 更多关节和连杆... -- /xacro:macro6. 常见问题与调试技巧6.1 属性未定义错误当看到Property xxx not found错误时检查属性名拼写确保属性在使用前已定义注意属性作用域宏内定义的属性在宏外不可见6.2 宏参数不匹配调用宏时如果参数数量或名称不匹配会导致错误确保调用时提供的参数与宏定义一致可选参数使用:语法提供默认值块参数使用*前缀6.3 文件包含路径问题使用$(find package_name)确保路径正确!-- 正确 -- xacro:include filename$(find my_robot)/urdf/parts/wheel.xacro / !-- 错误可能导致找不到文件 -- xacro:include filenameurdf/parts/wheel.xacro /6.4 调试技巧逐步注释大文件出错时逐步注释部分内容定位问题查看生成的URDF先转换为URDF检查输出使用--inorder参数老版本xacro可能需要此参数保证处理顺序检查XML格式确保所有标签正确闭合7. 性能优化建议合理拆分文件将大型模型按功能模块拆分到不同xacro文件避免深层嵌套过多嵌套的宏会影响可读性和性能重用计算结果对复杂计算使用属性缓存结果条件编译使用xacro:if避免生成不需要的URDF内容最小化属性作用域只在需要的地方定义属性8. 最佳实践命名规范属性使用小写加下划线wheel_radius宏使用驼峰命名或描述性名称createWheel或circular_actuator链接和关节名保持一致性arm_link1,arm_joint1模块化设计每个物理组件如轮子、传感器单独文件通用功能如材料定义集中管理配置参数与结构分离文档注释!-- 宏功能创建驱动轮 参数 - name: 轮子名称前缀 - parent: 父链接名称 - *origin: 安装位置和姿态 -- xacro:macro namewheel paramsname parent *origin ... /xacro:macro版本控制对xacro文件使用版本控制重大修改时创建新版本文件通过git子模块或rosdep管理共享组件参数验证xacro:macro namesafety_check paramsvalue min max xacro:if value${value min or value max} xacro:error message值 ${value} 超出范围 [${min}, ${max}] / /xacro:if /xacro:macro xacro:safety_check value${wheel_radius} min0.05 max0.2 /