3. 静态TF发布器：static_transform_publisher 的使用与参数解析

说到 TF 树里的「固定关系」，你第一个想到的肯定是 static_transform_publisher。说白了，它就是用来发布那些永远不会变的坐标变换——比如激光雷达装在机器人底盘上，或者摄像头固定在车头。这种变换在机器人启动时就定死了，运行期间不会动。

我个人习惯把静态发布器叫做「TF 树的锚点」。没有它，你的动态变换就失去了参考基准。我记得刚做机器人时，总想省掉静态发布，直接在代码里写死坐标……后来被同事骂了一顿，才老老实实用标准工具。嗯，专业的事交给专业的节点，没错。

3.1 静态变换 vs 动态变换

先理清一个概念：静态变换不是「发布频率低」，而是「变换矩阵永远不变」。动态变换会随时间变化，比如关节角度、里程计位姿。而静态变换一旦发布，TF 树就把它当作永恒真理。

• 静态变换：base_link → laser_frame，偏移量固定，无旋转变化。
• 动态变换：odom → base_link，随着机器人移动不断更新。

你想想看，如果激光雷达相对底盘的位姿都变了，那你的建图肯定崩。所以静态发布器就是用来锁死这种关系的。

3.2 static_transform_publisher 命令行用法

ROS 里最直接的方式就是通过 tf2_ros 包提供的可执行文件。你可以在 launch 文件中直接调用，也可以在终端里手敲。我个人偏爱在 launch 里用 node 标签，因为参数一目了然。

# 标准格式（ROS 1）
rosrun tf2_ros static_transform_publisher x y z yaw pitch roll frame_id child_frame_id

# 或者使用四元数（更推荐）
rosrun tf2_ros static_transform_publisher x y z qx qy qz qw frame_id child_frame_id

举个例子，假设你的激光雷达装在机器人前方 0.3 米，高度 0.2 米，完全水平：

rosrun tf2_ros static_transform_publisher 0.3 0 0.2 0 0 0 base_link laser_frame

这里 yaw、pitch、roll 都是 0，表示没有旋转。我刚开始总搞混 RPY 的顺序，后来干脆全用四元数，省心。

3.3 launch 文件中的典型用法

实际项目中，没人会在终端里一条条敲。我们通常把静态发布器写进 launch 文件：

<launch>
    <node pkg="tf2_ros" type="static_transform_publisher" name="base_to_laser" 
          args="0.3 0 0.2 0 0 0 base_link laser_frame" />
</launch>

注意 name 可以随便取，但最好有意义。我曾经见过有人把所有静态发布器都叫 "tf_pub"，结果调试时根本分不清谁是谁……

3.4 参数解析 —— 每个数字都是关键

static_transform_publisher 的参数看起来简单，但坑不少。我整理了一张表，你照着填基本不会错。

参数	类型	说明	注意事项
x, y, z	float (米)	平移分量，单位米	相对于父坐标系
yaw, pitch, roll	float (弧度)	欧拉角，绕 Z/Y/X 轴	顺序 ZYX，容易搞混
qx, qy, qz, qw	float	四元数，替代欧拉角	必须归一化，否则 TF 会警告
frame_id	string	父坐标系	必须已经存在于 TF 树中
child_frame_id	string	子坐标系	不能与父坐标系同名

3.5 使用四元数的理由

为什么我推荐四元数？因为欧拉角有顺序问题，而且当 pitch 接近 90° 时会出现万向锁。你想想看，如果你的摄像头朝下安装，用欧拉角很容易写出奇怪的数值。四元数虽然看起来不直观，但用工具转换一下就好。

# 从 RPY 转四元数（Python）
from tf_transformations import quaternion_from_euler
q = quaternion_from_euler(roll, pitch, yaw)
print(q)  # [qx, qy, qz, qw]

我个人习惯在 launch 文件里直接用四元数，避免 launch 解析时出幺蛾子。

3.6 静态发布器的生命周期

static_transform_publisher 节点启动后，会以 100Hz 的频率发布同一个变换。你可能会问：既然不变，为什么还要一直发？因为 TF 树需要时间戳，而且监听器会缓存最近的变换。如果发布频率太低，监听器可能因为缓存过期而报错。

• 默认发布频率：100 Hz
• 缓存时间：默认 10 秒（可通过参数修改）
• 节点退出后，变换消失

嗯，这里要注意：如果你在 launch 里用了 required="true"，静态发布器挂了整个机器人都会停。我一般不加 required，除非那个变换真的生死攸关。

3.7 常见错误与排查

我见过新手最常犯的错误：

1. 忘记启动静态发布器 —— 然后 TF 树里缺链，监听器一直报 "Lookup would require extrapolation"。
2. 单位搞错 —— 把厘米当米，或者角度用了度而不是弧度。
3. 坐标系名称拼写 —— "laser" 和 "laser_frame" 混用，大小写不一致。

如果你用 tf2_monitor 或者 view_frames 看到静态变换的发布频率是 0，那多半是节点没跑起来。检查一下 launch 里的 args 格式，少一个空格都可能报错。