Go Academy · 课时

Protocol Buffers 与 .proto 文件

Q: 「Protocol Buffers 与 .proto 文件」这节课中我会学到什么？

消息类型、服务与 protoc 代码生成 你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

消息类型、服务与 protoc 代码生成

Protocol Buffers 与 .proto 文件 是 CoddyKit 上的免费 Go Academy 课时。这是第 1 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Go Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Go Academy 课程共包含 4 节课。

什么是 Protocol Buffers

Protocol Buffers（protobuf）是 Google 开发的语言无关二进制序列化格式。它比 JSON 更小、更快，也是 gRPC 的标准传输格式。

.proto 文件语法

在 .proto 文件中定义消息和服务：

syntax = "proto3";
package user;
option go_package = "github.com/example/user/pb";

message User {
    int64 id   = 1;
    string name = 2;
    string email = 3;
}

service UserService {
    rpc GetUser (GetUserRequest) returns (User);
}
message GetUserRequest { int64 id = 1; }

字段编号

每个字段都有一个用于二进制编码的唯一编号（标签）。架构投入使用后，切勿更改现有字段编号——这会破坏兼容性。

proto3 默认值

在 proto3 中，所有字段都有默认值（数字为 0，字符串为 ""，布尔值为 false）。不存在必需字段与可选字段的区别——缺失字段会采用默认值。

安装 protoc

安装 Protocol Buffers 编译器和 Go 插件：

brew install protobuf
go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest

生成 Go 代码

运行 protoc 以生成 Go 结构体和 gRPC 存根：

protoc --go_out=. --go_opt=paths=source_relative \
       --go-grpc_out=. --go-grpc_opt=paths=source_relative \
       user/user.proto

生成的类型

protoc 会生成：每条消息对应一个 Go 结构体、获取方法、一个服务接口、一个未实现的服务器结构体，以及一个包含所有 RPC 方法的客户端结构体。

重复字段

使用 repeated 表示列表（映射为 Go 切片）：

message ListUsersResponse {
    repeated User users = 1;
}

枚举

在 proto3 中定义枚举。第一个值必须为 0（默认值）：

enum Role {
    ROLE_UNSPECIFIED = 0;
    ROLE_USER        = 1;
    ROLE_ADMIN       = 2;
}

众所周知的类型

google/protobuf 包提供常用类型：Timestamp、Duration、Struct（类似 JSON）、Any。请在 .proto 文件中导入它们。

import "google/protobuf/timestamp.proto";
message Event { google.protobuf.Timestamp created_at = 1; }

向后兼容性规则

安全的更改：添加新字段、添加新消息类型、添加新的枚举值。不安全的更改：更改字段编号、更改字段类型、移除字段（它们会静默地变为默认值）。

快速检查

protobuf 消息中的字段编号必须满足什么条件？

回顾：协议缓冲区

要点：

.proto 定义消息（字段和类型）以及服务（RPC）
字段编号是永久固定的——绝不要复用或更改它们
protoc + Go 插件会生成 Go 结构体和 gRPC 桩代码
重复字段 → 切片；枚举必须从 0 开始

常见问题解答

「Protocol Buffers 与 .proto 文件」课时是免费的吗？

是的 — 「Protocol Buffers 与 .proto 文件」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Go Academy 课程的其余内容，请升级到 CoddyKit PRO。 Go Academy 课程共包含 4 节课。

「Protocol Buffers 与 .proto 文件」这节课中我会学到什么？

消息类型、服务与 protoc 代码生成你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Go Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Go Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 1 节课，共 4 节。

「Protocol Buffers 与 .proto 文件」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Go Academy 课中编写并运行代码吗？

能。每节 Go Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Go Academy