3. 接口定义语言（IDL）：.msg、.srv、.action 文件结构、数据类型与字段规则

好，咱们今天聊聊 ROS2 的接口定义。说白了，这就是 ROS2 世界里大家约定好的“沟通语言”。你想想看，一个节点要发数据，另一个节点要收数据，总得有个双方都认的格式吧？这个格式，就是靠 IDL 来定义的。

我个人习惯，在开始一个新项目前，第一件事不是写代码，而是先把接口定好。接口稳了，后面开发才顺畅。我在项目中遇到过好几次，因为接口没设计好，后期改得头皮发麻。所以，这块内容值得你花点心思。

3.1 三种接口文件：.msg、.srv、.action

ROS2 里主要有三种接口文件，分别对应不同的通信模式。我刚开始学的时候也容易搞混，其实记住它们的核心用途就行。

• .msg（消息）：用于 Topic 通信。节点发布一个消息，其他节点订阅它。这是最常用的，比如发个速度指令、传个图像数据。
• .srv（服务）：用于 Service 通信。客户端发一个请求，服务端处理完返回一个响应。典型的一问一答模式，比如“请求地图数据”->“返回地图数据”。
• .action（动作）：用于 Action 通信。适合耗时较长的任务，比如“导航到目标点”。它比 Service 多了“反馈”和“取消”机制，可以实时告诉你任务进度。

嗯，这里要注意，这三种文件在语法结构上非常相似，都遵循 IDL 的规则。学会了 .msg，另外两个基本就通了。

3.2 文件结构与字段规则

咱们先看一个最简单的 .msg 文件长什么样：

# 这是一个示例消息文件
int32 id
string name
float64[3] position
bool is_ready

结构其实很简单：类型 + 字段名。每一行定义一个字段。字段名建议用小写加下划线，这是 ROS 社区的约定俗成。

我曾经犯过一个低级错误：字段名用了大写字母，结果编译报错找了半天。后来养成习惯，所有接口字段一律小写加下划线，再没出过问题。

.srv 文件稍微特殊一点，它用 --- 分隔请求和响应：

# 请求部分
int32 a
int32 b
---
# 响应部分
int32 sum

.action 文件则用三个 --- 分隔成三部分：目标、结果、反馈。

# 目标
geometry_msgs/PoseStamped target_pose
---
# 结果
bool success
string message
---
# 反馈
float32 progress_percent

3.3 数据类型详解

ROS2 的 IDL 支持的数据类型挺丰富的。我整理了一张表，方便你查阅：

类型	说明	示例
int8 / uint8	8位有/无符号整数	int8 temperature
int16 / uint16	16位有/无符号整数	int16 speed
int32 / uint32	32位有/无符号整数	int32 count
int64 / uint64	64位有/无符号整数	int64 timestamp
float32 / float64	32/64位浮点数	float64[3] position
bool	布尔值	bool is_active
string	字符串	string frame_id
byte	字节（等价于 uint8）	byte raw_data
char	字符（等价于 uint8）	char letter

除了基础类型，还支持数组和嵌套类型：

• 定长数组：float64[3] position，长度固定。
• 变长数组：int32[] data，长度不固定，用 [] 表示。
• 嵌套类型：直接引用其他 .msg 文件，比如 geometry_msgs/PoseStamped pose。

3.4 核心知识结构图

下面这张图，帮你理清 IDL 的整体脉络：

3.5 字段命名与最佳实践

最后，分享几个我踩坑后总结出来的字段命名规则：

• 用小写加下划线：比如 target_pose，别用 targetPose 或 TargetPose。
• 字段名要有意义：别用 a、b、tmp 这种，过两天你自己都看不懂。
• 避免保留字：别用 type、data、header 这些容易冲突的词。
• 单位写在注释里：比如 float64 speed # 单位：m/s，这样别人用起来一目了然。

好了，接口定义这块就聊到这儿。说白了，就是定好规矩，大家按规矩办事。你只要把 .msg、.srv、.action 这三种文件的结构和数据类型搞明白，后面写节点通信代码就会顺手很多。