第3章 静态变换发布器：使用 static_transform_publisher 发布固定坐标关系
说到 TF，最基础也最常用的就是静态变换了。说白了，就是两个坐标系之间永远不变的那个关系——比如激光雷达装在机器人底盘正前方 10 厘米处，这个偏移量只要不拆螺丝就不会变。我刚开始接触 ROS2 导航时，第一个要搞定的就是这玩意儿。
这一章咱们就专门聊聊 static_transform_publisher。你想想看，整个导航系统里，哪些坐标关系是固定的？
- 传感器与基座：激光雷达、深度相机、IMU 相对于机器人底盘的位置
- 轮子与底盘：虽然轮子会转，但轮轴中心到底盘原点的偏移是固定的
- 多机器人中的固定基站：比如地面基站与机器人之间的相对位姿
嗯，这些场景用动态变换发布器反而浪费资源。静态变换发布器只发布一次，或者以极低频率发布，省带宽、省 CPU。
3.1 静态变换发布器的两种用法
ROS2 里提供了两种方式来发布静态变换。我个人习惯根据场景选，下面分别说。
3.1.1 命令行方式（最快捷）
如果你只是临时测试，或者想快速验证坐标关系对不对，直接在终端敲一行命令就行：
ros2 run tf2_ros static_transform_publisher x y z yaw pitch roll frame_id child_frame_id举个例子，假设我的机器人底盘叫 base_link，激光雷达叫 laser_frame，装在底盘前方 0.3 米、高度 0.2 米，完全水平：
ros2 run tf2_ros static_transform_publisher 0.3 0 0.2 0 0 0 base_link laser_frame这里六个参数分别是平移 (x, y, z) 和旋转 (yaw, pitch, roll)，单位是米和弧度。注意顺序——先平移后旋转，旋转是欧拉角。
tf2_echo 看结果，慢慢调。我在调试 AGV 时经常这么干，比一遍遍改 launch 文件快多了。
3.1.2 Launch 文件方式（推荐生产环境）
项目里肯定不能每次手动敲命令。我建议把静态变换写进 launch 文件，这样启动导航系统时自动加载。
# static_tf.launch.py
from launch import LaunchDescription
from launch_ros.actions import Node
def generate_launch_description():
return LaunchDescription([
Node(
package='tf2_ros',
executable='static_transform_publisher',
arguments=['0.3', '0', '0.2', '0', '0', '0', 'base_link', 'laser_frame']
)
])你看，本质上还是调用同一个可执行文件，只是放到了 launch 里。这样做的好处是：
- 所有坐标关系集中管理，一目了然
- 可以配合条件判断，比如仿真和实车用不同的参数
- 启动时自动运行，不会忘记
3.2 核心参数详解
这里我把参数整理成表格，方便你查阅。我曾经因为搞混 yaw 和 pitch 的顺序，让雷达数据在地上画了半小时圈……
| 参数 | 含义 | 单位 | 注意事项 |
|---|---|---|---|
| x, y, z | 平移分量 | 米 | 相对于父坐标系 |
| yaw | 偏航角（绕 Z 轴） | 弧度 | 右手定则，逆时针为正 |
| pitch | 俯仰角（绕 Y 轴） | 弧度 | 抬头为正 |
| roll | 横滚角（绕 X 轴） | 弧度 | 向右倾斜为正 |
| frame_id | 父坐标系名称 | 字符串 | 必须与 TF 树中已有坐标系一致 |
| child_frame_id | 子坐标系名称 | 字符串 | 不能与父坐标系同名 |
3.3 静态变换的核心逻辑
为了让你更直观地理解，我画了一张图。这张图展示了静态变换在 TF 树中的位置——它就像一棵树上的固定枝干，永远不会自己动。
从图里能清楚看到：odom → base_link 是动态变换，因为机器人会移动；而 base_link → laser_frame 是静态变换，只要不拆硬件，这个关系永远不变。
3.4 验证静态变换是否生效
发布完了，怎么知道对不对？我一般用两个命令来检查。
方法一：查看 TF 树
ros2 run tf2_tools view_frames.py这个命令会生成一个 PDF 文件，里面画出了当前所有 TF 关系。静态变换会显示为一条直线，没有时间戳波动。
方法二：用 echo 实时监听
ros2 run tf2_ros tf2_echo base_link laser_frame输出应该稳定不变，比如：
At time 0.000
- Translation: [0.300, 0.000, 0.200]
- Rotation: in Quaternion [0.000, 0.000, 0.000, 1.000]TransformBroadcaster 代替了 StaticTransformBroadcaster，结果 TF 树里多了一大堆冗余更新。
3.5 静态变换的发布频率与生命周期
静态变换发布器默认每 100 秒发布一次。为什么是 100 秒？因为 ROS2 的 TF 缓存默认保留 10 秒，100 秒的间隔足够保证缓存里始终有数据，又不会频繁占用网络。
我个人习惯在 launch 文件里加一个 --rate 参数，比如设成 50 秒一次：
Node(
package='tf2_ros',
executable='static_transform_publisher',
arguments=['0.3', '0', '0.2', '0', '0', '0', 'base_link', 'laser_frame'],
parameters=[{'rate': 50.0}]
)不过说实话，默认值已经够用了。除非你的系统对带宽极其敏感，否则不用改。
3.6 常见问题与避坑
- 坐标系名称拼写错误：大小写敏感！
base_link和Base_Link是两个不同的坐标系。我见过有人因为首字母大写，查了一下午 bug。 - 父子关系搞反：记住，父坐标系是参考系，子坐标系是依附于父的。激光雷达装在底盘上，父就是
base_link，子就是laser_frame。 - 多个静态变换冲突：如果你不小心启动了两次相同的静态变换发布器，后启动的会覆盖前面的。但如果有两个不同的节点发布了同一个父子关系，TF 树会报 warning。
好了，静态变换发布器就聊到这儿。说白了它就是 TF 世界里最老实的那部分——永远不变，永远可靠。不过在那之前，建议你亲手跑一遍上面的命令，感受一下。