Wire Format 是数据结构或消息在通信链路上传输时的具体字节表示，包括字段顺序、类型编码、长度、字节序、分隔方式和兼容性规则。
核心问题
程序内部的数据通常是对象、结构体、字典或类实例，但网络只能传输字节。Wire Format 解决的是“同一个逻辑数据如何被编码成可传输、可解析、可演进的字节序列”。
如果没有稳定的 Wire Format，发送方和接收方即使知道业务字段含义，也可能因为字段边界、整数大小、字符编码或版本差异而解析失败。
核心机制
Wire Format 一般关注单条消息或单个值的编码规则：
- 字段标识：字段靠固定位置、字段名、tag 编号或键值对来识别。
- 类型编码：整数、浮点数、字符串、布尔值、数组和嵌套对象各自如何编码。
- 长度与边界：用定长、长度前缀、终止符、分隔符或容器结构标出边界。
- 字节序：多字节整数按大端还是小端排列。
- 兼容性：未知字段能否跳过、字段能否缺省、版本号是否参与解析。
- 压缩与加密位置：先编码再压缩，还是在传输层或记录层处理。
JSON、YAML 这类文本格式更容易阅读；Protocol Buffers、MessagePack、CBOR 等二进制格式通常更紧凑、解析更快，但需要更严格的 schema 和测试向量。
与 Wire Protocol 的区别
Wire Protocol 是更大的约定，包含消息格式、握手、状态机、流控、错误处理和交互流程。Wire Format 只回答“这个值或这条消息如何编码成字节”。
可以把它们粗略区分为：
- Wire Format：一条消息怎么长。
- Wire Protocol：双方怎么用这些消息完成一次通信。
例如 WebSocket 的协议包含握手、控制帧、关闭流程和数据帧规则；其中每个帧的 opcode、mask、payload length 和 payload 的布局就是 Wire Format 层面的内容。
工程用途
- 跨语言兼容：不同语言实现只要按同一 Wire Format 编解码，就能互通。
- 存储与回放：日志、离线队列、快照和消息队列常依赖稳定的二进制或文本格式。
- 性能评估：格式选择影响消息大小、CPU 解析成本、内存分配和压缩收益。
- 版本演进：新增字段、字段重命名、默认值和未知字段处理决定升级是否平滑。
- 故障定位：抓包、十六进制 dump 和测试向量可以直接定位字段错位、长度错误或字节序错误。
边界与常见坑
- 可读不等于稳定：文本格式如果没有规范化规则，字段顺序、空白、大小写和数字表示都可能影响签名或缓存。
- 紧凑不等于高性能：二进制格式减少带宽，但 schema 复杂、反射解析或频繁分配也会拖慢系统。
- 不要忽略字节序：多语言、多平台通信时，字节序不统一会让整数和浮点数解析成错误值。
- 不要把内部对象布局直接当 Wire Format：内存对齐、指针、语言运行时对象头和平台 ABI 都不适合直接跨进程或跨机器传输。
- 格式演进要有测试向量：只靠当前 SDK 的单元测试，容易漏掉旧客户端、未知字段和缺省值组合。