1.基本概念

在 Protocol Buffers（protobuf）中，Wire Type 指的是在二进制序列化时，用来标识一个字段在 wire（网络传输或存储的字节流）中应该用什么方式编码的类型标识。

它是 protobuf 二进制编码格式的核心组成部分，决定了数据的存储方式和解析规则。

每个 protobuf 字段在序列化时，会将其 字段编号（field number） 和 wire type 组合成一个 key（也叫 tag），然后跟着 value。

key = (field_number << 3) | wire_type

这个 key 是一个 varint，其中：

• 低 3 位（bit 0-2）存储 wire type
• 高位（bit 3 及以上）存储 field number

2.类型表

Groups 已废弃：wire type 3 和 4 是早期 protobuf 2 中用于支持“groups”的，现已被推荐使用嵌套消息代替，几乎不再使用。

3.举例说明

假设有如下 .proto 定义：

message Person {
  int32  id   = 1;   // wire type = 0 (Varint)
  string name = 2;   // wire type = 2 (Length-delimited)
  double score = 3;  // wire type = 1 (64-bit)
}

当 id = 12345，name = "Alice"，score = 98.6 时，二进制编码大致如下（简化）：

# 字段 id (field_number=1, wire_type=0)
key = (1 << 3) | 0 = 0x08
value = 12345 的 varint 编码

# 字段 name (field_number=2, wire_type=2)
key = (2 << 3) | 2 = 0x12
length = 5
value = "Alice" 的 UTF-8 字节 (5 bytes)

# 字段 score (field_number=3, wire_type=1)
key = (3 << 3) | 1 = 0x19
value = 98.6 的 64-bit 固定长度编码 (8 bytes)

4.关键作用

5.兼容性

这就是为什么 protobuf 强调 “不要随意改变字段的 wire type”，否则老代码解析新数据时会失败。

6.一句话总结

Wire Type 是 protobuf 二进制编码中，用来标识字段在 wire 上采用哪种编码方式（varint、固定长度、或带长度前缀）的类型标识（低 3 位）。它决定了解析器如何读取该字段的值，是实现 protobuf 高效编码和向后兼容的关键机制。

参考

ProtoBuf 文档: Protocol Buffers 文档