protobuf 语法介绍
2026-10-31 18:31:48
Protocol Buffers（protobuf）是一种高效的数据序列化工具，其语法简洁且功能强大。以下是对protobuf语法的详细介绍：
语法版本：
syntax = "proto3";：指定使用proto3语法版本，若未指定则默认为proto2。
包名设置：
package test;：设置包名，用于避免命名冲突。
Go语言选项：
option go_package = "/test;test";：前半部分设置生成Go文件的路径，后半部分设置Go文件的包名。
消息定义：
使用message关键字定义消息类型，如message RequestInfo { int64 number1 = 1; int64 number2 = 2; }。
消息内包含字段，每个字段有类型、名称和唯一的标识号。
枚举类型：
使用enum关键字定义枚举，如enum Corpus { CORPUS_UNSPECIFIED = 0; CORPUS_UNIVERSAL = 1; }。
proto3中枚举的第一个值必须为0，作为默认值。
数组/重复字段：
使用repeated关键字表示字段可重复多次，即数组类型，如repeated User users = 1;。
Map类型：
使用map<key_type, value_type> field_name = field_number;语法定义map类型字段。
默认值：
字符串默认为空字符串，字节默认为空字节，布尔默认为false，数值类型默认为0，枚举默认为第一个值（必须为0），消息字段未设置时取决于具体语言实现。
字段修饰符：
optional表示字段可选，required表示字段必填（proto3中已移除required修饰符）。
数据类型：
protobuf支持多种数据类型，如double、float、int32、int64、uint32、uint64、sint32、sint64、fixed32、fixed64、sfixed32、sfixed64、bool、string、bytes等，并对应到不同语言的特定类型。
服务定义：
使用service关键字定义RPC服务，如service SearchService { rpc Search(SearchRequest) returns (SearchResponse); }。
服务内包含方法，每个方法有名称、参数和返回值。
导入其他包：
使用import语句导入其他.proto文件，以使用其中的定义，如import "other.proto";。
protobuf语法通过简洁的规则定义了数据结构和服务接口，支持多种数据类型，并提供了灵活的字段修饰符和默认值设置。通过消息、枚举、数组、map等结构，可以方便地描述复杂的数据模型。同时，protobuf还支持定义RPC服务，便于实现远程过程调用。导入功能则增强了代码的复用性和模块化。
热门标签
