Golang使用Protobuf定义数据结构示例

36次阅读

使用Protobuf定义User消息结构并生成go代码，实现高效序列化与反序列化。2. 通过protoc编译器生成user.pb.go文件，包含对应Go结构体和方法。3. 在Go中创建User实例，调用proto.Marshal和proto.Unmarshal进行数据编码与解码。4. 输出结果显示完整数据还原，验证通信或存储可行性。

在Go语言中使用Protobuf（Protocol Buffers）定义数据结构，可以高效地进行序列化和反序列化，常用于微服务通信或存储场景。下面是一个完整的示例，展示如何用Protobuf定义结构、生成Go代码并使用它。

1. 定义.proto文件

创建一个名为 user.proto 的文件，内容如下：

syntax = “proto3”;

option go_package = “./;pb”; // 指定生成的Go包路径和包名

message User {
  string id = 1;
  string name = 2;
  int32 age = 3;
  bool active = 4;
  repeated string roles = 5; // 支持切片
}

说明：

syntax = “proto3” 使用Proto3语法。
message User 定义一个名为User的数据结构。
字段后的数字（如=1）是字段的唯一标识符，用于二进制编码。
repeated 表示该字段为列表类型（对应Go中的slice）。

2. 生成Go代码

确保已安装以下工具：

protoc 编译器（从 https://github.com/protocolbuffers/protobuf 下载）
Go插件：执行 go install google.golang.org/protobuf/cmd/protoc-gen-go@latest

在.proto文件所在目录运行命令：

protoc –go_out=. user.proto

Openflow

一键极速绘图，赋能行业工作流

31

查看详情

这会生成一个 user.pb.go 文件，包含对应的Go结构体和序列化方法。

3. 在Go中使用生成的结构

编写main.go测试代码：

package main

import (
“fmt”
“log”

“github.com/golang/protobuf/proto”
“your-module/pb” // 替换为你的模块路径
)

func main() {
  // 创建User实例
  user := &pb.User{
    Id: “1001”,
    Name: “Alice”,
    Age: 30,
    Active: true,
    Roles: []string{“admin”, “user”},
  }

  // 序列化为二进制
  data, err := proto.Marshal(user)
  if err != nil {
    log.Fatal(“序列化失败:”, err)
  }

  // 反序列化
  newUser := &pb.User{}
  if err := proto.Unmarshal(data, newUser); err != nil {
    log.Fatal(“反序列化失败:”, err)
  }

fmt.Printf(“用户信息: %+vn”, newUser)
}

输出示例：
用户信息: id:”1001″ name:”Alice” age:30 active:true roles:”admin” roles:”user”