Protobuf Decoder / Encoder
JSON Input (Message Data)
tag = (field_number << 3) | wire_type followed by the encoded value. Wire types: 0=Varint, 1=64-bit, 2=Length-delimited, 5=32-bit. Tags and varints use base-128 encoding.技术详情
Protobuf 编解码器的工作原理
工具功能
Protobuf（Protocol Buffers）编解码器可在 JSON 与 Protobuf 二进制格式之间互相转换。Protobuf 是 Google 开发的语言中立、平台中立的可扩展序列化格式，广泛用于 gRPC 通信、微服务数据交换和配置文件存储。该工具帮助开发者可视化 Protobuf 编码的二进制数据，或将 JSON 数据编码为 Protobuf 格式用于测试。
常见开发者使用场景
Protobuf 在微服务架构中无处不在：gRPC 服务调用使用 Protobuf 作为默认序列化格式以降低网络开销、移动应用与后端通信时使用 Protobuf 减小数据体积、Kafka/消息队列中使用 Protobuf 模式管理消息格式、以及配置管理系统使用 Protobuf 定义配置结构。与 JSON 相比，Protobuf 编码数据通常小 3-10 倍，解析速度快 20-100 倍。
与其他二进制序列化格式的对比可参考 CBOR/MessagePack 转换器。JSON-YAML 转换器 处理文本格式转换。Varint 编解码器 是实现 Protobuf 编码的核心技术之一。Base64 编解码器 可用于编码二进制 Protobuf 数据。
技术原理/相关概念
Protobuf 使用 .proto 文件定义消息的 schema，编译器根据 schema 生成各语言的代码。在二进制格式中，每个字段编码为 tag（字段编号 + wire type）+ value 的对。Wire type 包括：varint（0，用于 int32/uint32/bool/enum 等）、64-bit（1，固定 8 字节）、Length-delimited（2，字符串/字节/嵌套消息，前缀为长度）、32-bit（5，固定 4 字节）。Protobuf 使用 varint 编码整数，小数值占更少字节，负数在 sint32 中使用 zigzag 编码优化。
常见陷阱与注意事项
- 需要 Schema：没有 .proto 文件的二进制数据极难直接解读。本工具需要 schema 信息才能正确反序列化。
- 字段编号不可变：Protobuf schema 中的字段编号一旦使用就不应更改，改变编号会破坏向后兼容性。
- 默认值不编码：Protobuf 不编码默认值（int32 的 0、bool 的 false、空字符串），这是导致数据"丢失"的常见原因。
- 版本兼容：Proto2 和 Proto3 的默认值处理、unknown fields 保留等行为有差异，混合使用需谨慎。
何时使用此工具而非代码
在调试 Protobuf 二进制数据、学习 Protobuf 编码机制或快速测试序列化结果时使用此工具。适合 gRPC 开发者的调试场景。对于生产环境，直接使用 protoc 编译器和语言相关的 Protobuf 库（如 google-protobuf、protobuf.js）是标准方式，它们提供 schema 验证、自动代码生成和优化的编解码性能。