Go语言通过Protobuf定义数据结构可提升通信效率。1. 安装protoc编译器和Go插件；2. 编写.proto文件定义消息格式；3. 生成Go代码并使用proto.Marshal/Unmarshal进行序列化与反序列化，适用于gRPC等场景。
在Go语言中使用Protocol Buffer（简称Protobuf）定义数据结构，能有效提升服务间通信效率和数据序列化性能。Protobuf是Google开发的一种语言中立、平台中立的结构化数据序列化格式，常用于网络传输和数据存储。
安装Protobuf编译器与Go插件
要使用Protobuf，需先安装官方编译器 protoc 和Go语言支持插件。
- 下载并安装 protoc：从 GitHub Releases 获取对应系统的版本。
- 安装Go插件：
go install google.golang.org/protobuf/cmd/protoc-gen-go@latest - 确保 $GOPATH/bin 在系统PATH中，以便 protoc 能调用Go插件。
编写 .proto 文件定义数据结构
在项目中创建 example.proto 文件，使用Proto3语法定义消息结构。
syntax = "proto3";package example;
option go_package = "./examplepb";
message Person {
string name = 1;
int32 age = 2;
string email = 3;
}
message UserList {
repeated Person users = 1;
}
- syntax = "proto3" 指定使用Proto3语法。
- package 定义命名空间，避免名称冲突。
- option go_package 指定生成Go文件的包路径。
- message 定义结构体，字段后数字为唯一标签（tag），用于序列化。
- repeated 表示该字段为列表类型。
生成Go代码
使用 protoc 命令将 .proto 文件编译为Go代码。
立即学习“go语言免费学习笔记（深入）”；
protoc --go_out=. example.proto执行后会生成 examplepb/example.pb.go 文件，其中包含：
- 对应每个 message 的Go结构体（如 Person、UserList）。
- 实现了 proto.Message 接口。
- 自动生成 Marshal 和 Unmarshal 方法用于序列化。
在Go程序中使用生成的结构
导入生成的包，即可像普通结构体一样使用。
package mainimport (
"fmt"
"log"
"github.com/your-module/examplepb"
"google.golang.org/protobuf/proto"
)
func main() {
person := &examplepb.Person{
Name: "Alice",
Age: 30,
Email: "alice@example.com",
}
data, err := proto.Marshal(person)
if err != nil {
log.Fatal("marshaling error: ", err)
}
newPerson := &examplepb.Person{}
if err := proto.Unmarshal(data, newPerson); err != nil {
log.Fatal("unmarshaling error: ", err)
}
fmt.Println(newPerson.GetName()) // 输出: Alice
}
- 使用 proto.Marshal 将结构体编码为二进制。
- 使用 proto.Unmarshal 从字节流还原结构体。
- 字段通过Getter方法访问（如 GetName()），这是Protobuf生成代码的规范。
