无需登录 数据私有 本地保存

JSON 转 Protobuf 消息定义生成器 - 自动推断 .proto

代码生成 开发工具 JSON Protobuf 序列化 生成器
9
0
0
0

JSON 转 Protobuf 消息定义生成器

粘贴 JSON 数据，自动推断并生成 .proto 文件定义，支持嵌套结构、枚举检测与多样本合并。

JSON 输入 支持数组多样本
简单对象 嵌套结构 数组样本
生成的 .proto 定义
等待 JSON 输入...

常见问题与知识点

什么是 Protobuf（Protocol Buffers）？▼
Protocol Buffers 是 Google 开发的一种语言中立、平台无关的结构化数据序列化协议。它比 JSON 更小、更快、更强类型，广泛应用于微服务通信（gRPC）、数据存储和配置文件。通过 .proto 文件定义消息结构后，可自动生成多语言的数据访问代码。
JSON 转 Protobuf 有什么优势？▼
将 JSON 数据结构转换为 Protobuf 定义可以带来多项优势：更小的传输体积（二进制编码比文本JSON小3-10倍）、更快的解析速度、强类型校验减少运行时错误、向后兼容性更好管理、以及自动生成客户端代码，提升开发效率。
工具如何自动推断字段类型？▼
工具通过分析 JSON 中每个字段的实际值来推断对应的 Proto 类型：string → string，boolean → bool，整数数字 → int64/int32，浮点数字 → double，对象 → 嵌套 message，数组 → repeated，null → 标记为可选字段。如果提供多个样本，工具会合并所有样本来获得更准确的推断。
proto2 和 proto3 该如何选择？▼
proto3 是当前主流版本，语法更简洁，移除了 required/optional 关键字（3.15+重新引入optional），所有字段默认可选，枚举第一个值必须为0。适合新项目。proto2 提供更精细的字段控制（required/optional/repeated），适合需要强制字段存在性的遗留系统。大多数现代项目推荐使用 proto3。
什么是 repeated 字段？如何处理 JSON 数组？▼
repeated 是 Protobuf 中表示数组/列表的关键字。当 JSON 中某个字段的值是数组时，工具会自动将其标记为 repeated。如果数组元素是对象，工具会创建一个嵌套 message 来描述元素结构；如果数组元素是基础类型（如字符串数组），则直接使用 repeated string 等形式。
为什么建议提供多个 JSON 样本？▼
单个 JSON 样本可能不包含所有可选字段，导致生成的 proto 定义不完整。通过提供多个样本（放入 JSON 数组中），工具可以：发现所有可能的字段、更准确判断字段是否可选、检测枚举值（如果某字段在多样本中只有少数固定值）、处理数组元素类型不一致的情况。
字段编号有什么规则和最佳实践？▼
Protobuf 字段编号范围是 1 到 536,870,911（19000-19999 为保留范围不可用）。编号 1-15 使用1字节编码，应优先分配给最常用的字段以节省空间。16-2047 使用2字节。编号一旦分配就不应更改，删除字段时应将其标记为 reserved 以防止未来重用。本工具按字段出现顺序从起始编号自动分配。
生成的 .proto 文件可以直接使用吗？▼
生成的 proto 文件是一个高质量的起点，通常可以直接使用。但建议人工检查以下方面：字段类型是否准确（特别是整数范围，可能需要调整为 int32/int64/sint64/uint64）、枚举值名是否语义清晰、嵌套 message是否需要提取为可复用的独立 message、是否需要引入 google.protobuf.Timestamp 等知名类型来替代普通数字/字符串时间字段。
🔧 相关工具