功能说明
本工具将 JSON 对象转换为 Protocol Buffers(protobuf)的 .proto 定义文件。您只需粘贴一段 JSON,工具会自动分析数据结构,生成对应的 message 定义,包括字段类型、字段编号、嵌套消息等。
使用方法
- 在输入区粘贴 JSON 文本(必须是对象,不能是数组或字符串)。
- 可修改根消息名称(默认 RootMessage)。
- 选择 proto 版本(proto3 或 proto2),以及是否生成 package 声明。
- 点击“生成 Proto”或直接输入,结果会显示在下方。
计算原理
工具递归遍历 JSON 的每个字段:
- 字符串 →
string - 整数 →
int32 - 小数 →
double - 布尔 →
bool - 数组 →
repeated+ 元素类型 - 对象 → 生成新的 message 并引用
字段编号从 1 开始递增,嵌套消息命名为“父消息_字段名”(首字母大写)。
注意事项
- JSON 键名会转换为合法的 proto 字段名(非字母数字下划线替换为下划线,数字开头加下划线)。
- 空数组默认使用
repeated string。 - proto3 中字段默认非 optional,如需显式标记可勾选“字段使用 optional”。
- 生成结果仅供参考,实际使用时可能需要根据业务调整字段类型和命名。