相较于文本编码的 JSON

• 速度快（序列化和反序列化）
• 数据小（二进制数据流更加紧凑）
• 数据类型丰富（enum，map...）
• 可读性差

数据类型

1. 枚举类型，有另一篇文章可供参考：Protobuf 枚举类型的实现

2. 数组（Repeated）示例：

   message Person {
       repeated string hobbies = 5;
   }
   

3. 映射（Map）示例：

   message Person {
       map<string, string> contacts = 6;
   }
   

   这里 contacts 是一个键为字符串、值也为字符串的映射。

基本流程

1. 定义数据结构（.proto 文件）
2. 使用编译器生成目标编程语言代码

3. 在程序中引入生成的代码

4. Protobuf 编译器: protoc，作用是生成目标语言的数据定义代码
   生成的代码
   需要到 GitHub 下载。

5. Protobuf 运行时，作用是序列化和反序列化的基础库

   Lang	Repo
   C++	https://github.com/protocolbuffers/protobuf/blob/main/src
   Java	https://github.com/protocolbuffers/protobuf/blob/main/java
   Python	https://github.com/protocolbuffers/protobuf/blob/main/python
   Golang	https://github.com/protocolbuffers/protobuf-go

示例

1. proto 文件

   syntax = "proto3";
   
   package example;
   
   message Person {
       enum Gender {
           UNKNOWN = 0;
           MALE = 1;
           FEMALE = 2;
       }
       string name = 1;
       int32 age = 2;
       Gender gender = 3;
   }
   

2. 编译：

   $ protoc --go_out=. --go_opt=Mexample.proto=./generated example.proto
   $ find .
   .
   ./example.proto
   ./generated
   ./generated/example.pb.go
   

3. 调用 proto 生成的 Go 代码

   package main
   
   import (
       "fmt"
       "log"
   
       pb "example/generated" // 导入生成的包
   
       "google.golang.org/protobuf/proto"
   )
   
   func main() {
       // 创建一个 Person 实例
       person := &pb.Person{
           Name:   "Alice",
           Age:    30,
           Gender: pb.Person_FEMALE,
       }
   
       // 序列化
       data, err := proto.Marshal(person)
       if err != nil {
           log.Fatalf("Failed to marshal: %v", err)
       }
   
       // 反序列化
       newPerson := &pb.Person{}
       err = proto.Unmarshal(data, newPerson)
       if err != nil {
           log.Fatalf("Failed to unmarshal: %v", err)
       }
   
       fmt.Printf("Deserialized person: %+v\n", newPerson)
   }
   

   $ go mod init example
   $ go mod tidy
   
   $ go build -o main.exe .
   $ ./main.exe
   Deserialized person: name:"Alice" age:30 gender:FEMALE