Protocol Buffers 工具
编码、解码和验证 Protocol Buffers 消息
Proto 模式
模式信息
输入
解析模式并选择消息类型以生成表单字段
输出
原始字段
| 字段编号 | 线类型 | 值 |
|---|
Protocol Buffers 文档
什么是 Protocol Buffers？
Protocol Buffers（Protobuf）是由 Google 开发的一种语言无关、平台无关的可扩展序列化结构化数据机制。在数据序列化方面，它比 XML 和 JSON 更小、更快、更简单。
主要特性
- 语言无关、平台无关
- 比 XML/JSON 更小更快
- 通过模式定义实现强类型
- 向前和向后兼容
- 自动代码生成
- 高效的二进制编码
如何使用此工具
- 在模式编辑器中输入您的 .proto 模式定义
- 点击【解析模式】来验证和解析模式
- 选择您要操作的消息类型
- 编码时：输入 JSON 数据，点击【编码】
- 解码时：输入二进制数据，点击【解码】
- 使用【原始解码】在没有模式的情况下分析二进制数据
工具功能
编码
将 JSON 数据转换为 Protocol Buffers 二进制格式。支持基于表单的输入，便于数据录入和类型验证。
解码
将 Protocol Buffers 二进制数据转换回可读的 JSON 格式。支持 Base64、十六进制和 C 风格十六进制输入格式。
原始解码
无需模式即可分析 protobuf 二进制数据。适用于调试、逆向工程或分析未知消息。
表单输入
友好的表单界面，根据您的模式自动生成输入表单。支持嵌套消息、枚举和重复字段。
Proto 语法参考
Protocol Buffers 使用简单的语法来定义消息类型：
syntax = "proto3";
message Person {
string name = 1;
int32 id = 2;
string email = 3;
enum PhoneType {
MOBILE = 0;
HOME = 1;
WORK = 2;
}
message PhoneNumber {
string number = 1;
PhoneType type = 2;
}
repeated PhoneNumber phones = 4;
}
syntax: 指定 protobuf 版本（proto2 或 proto3）message: 定义包含字段的消息类型field: 每个字段都有类型、名称和唯一编号enum: 定义枚举类型repeated: 将字段标记为重复（数组/列表）optional: 将字段标记为可选（proto3）
标量类型
Protocol Buffers 支持多种标量类型：
| 类型 | 描述 | 默认值 |
|---|---|---|
| int32, int64 | 有符号整数（变长编码） | 0 |
| uint32, uint64 | 无符号整数 | 0 |
| sint32, sint64 | 使用 ZigZag 编码的有符号整数（对负数高效） | 0 |
| fixed32, fixed64 | 固定宽度无符号整数（4 或 8 字节） | 0 |
| sfixed32, sfixed64 | 固定宽度有符号整数（4 或 8 字节） | 0 |
| float, double | 浮点数（32 或 64 位） | 0.0 |
| bool | 布尔值（true/false） | false |
| string | UTF-8 编码的文本字符串 | "" |
| bytes | 任意二进制数据 | empty |
线类型
Protobuf 使用线类型来确定如何从二进制数据中读取值：
| 线类型 | 含义 | 适用类型 |
|---|---|---|
| 0 | Varint | int32, int64, uint32, uint64, sint32, sint64, bool, enum |
| 1 | 64-bit | fixed64, sfixed64, double |
| 2 | Length-delimited | string, bytes, embedded messages, packed repeated |
| 5 | 32-bit | fixed32, sfixed32, float |
最佳实践
- 新项目使用 proto3 语法 - 更简单且支持更广泛
- 保持字段编号稳定 - 永远不要重用或更改现有字段的编号
- 使用有意义的字段名称来清楚描述数据
- 为常用字段保留编号 1-15（它们只使用 1 个字节）
- 使用 'repeated' 关键字表示数组/列表
- 为具有固定可能值集合的字段定义枚举
常见问题
什么是 Protocol Buffers (Protobuf)？
Protocol Buffers 是一种语言中立、平台中立的结构化数据序列化机制。它类似于 JSON，但体积更小、速度更快，并且可以生成原生语言绑定。它广泛应用于 gRPC 微服务中。
如何使用这个在线 Protobuf 工具？
首先，将您的 `.proto` 模式定义粘贴到编辑器中（或加载示例）。点击“解析 Schema”并选择消息类型。然后，您可以在“编码”（JSON → 二进制）和“解码”（二进制 → JSON）模式之间切换以处理您的数据。
什么是“原始解码”（Raw Decode）？
原始解码允许您在没有 `.proto` 文件的情况下检查二进制 Protobuf 消息。它解析二进制结构并显示字段编号、Wire Type 和值，这对于调试或逆向工程未知数据包非常有用。
我的数据处理安全吗？
是的。此工具使用 JavaScript (protobuf.js) 100% 在您的浏览器中运行。您的 Schema、JSON 数据和二进制数据永远不会发送到我们的服务器，确保您的敏感信息保密。
常见用例
- 微服务间通信（gRPC）
- 数据存储和缓存
- 配置文件
- 网络协议和 API