protoc-gen-go 和 protoc-gen-go-grpc 必须分别安装，前者生成 message 结构体，后者生成 service 接口；go_package 需显式声明为 "./pkg;pkg" 或模块路径；字段编号 1–15 应优先分配高频小字段；stream 方法返回类型必须带 stream 关键字。
protoc-gen-go 和 protoc-gen-go-grpc 必须分开安装
Go 生态里，protoc-gen-go 和 protoc-gen-go-grpc 是两个独立插件，不能只装一个。前者负责生成 .proto 中 message 对应的 Go 结构体（即数据层），后者才生成 service 对应的 gRPC 接口代码（即 RPC 层）。漏掉 protoc-gen-go-grpc 会导致 protoc --go-grpc_out=. 报错：protoc-gen-go-grpc: program not found or is not executable。
安装命令必须分两步执行：
go install google.golang.org/protobuf/cmd/protoc-gen-go@latestgo install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
注意：这两个二进制文件默认落在 $GOPATH/bin，需确保该路径已加入 $PATH；macOS 上若用 Homebrew 安装过 protobuf，protoc 命令本身是系统级的，但 Go 插件仍需单独安装。
option go_package 必须显式声明且格式正确
不写 option go_package 或写错，会导致生成的 Go 代码无法被正常 import。常见错误包括：
立即学习“go语言免费学习笔记（深入）”；
- 只写包名如
option go_package = "user";→ 生成代码会放在默认包路径下，import 路径与实际不符 - 路径含空格或非法字符 →
protoc直接报错退出 - 多个
.proto文件共用同一go_package值但分散在不同目录 → Go 编译器报重复定义
推荐写法：option go_package = "./user;user"（本地相对路径 + 包名），或更明确的模块路径：option go_package = "github.com/yourorg/yourproject/user;user"。前者适合单模块项目，后者利于多服务复用和 go mod 管理。
字段编号 1–15 是性能关键点，别乱分配
Protobuf 二进制编码中，字段编号 1–15 只占 1 字节，而 16–2047 占 2 字节。高频字段（如 id、name、status）若用了编号 20，每个消息多出 1 字节，万级并发下就是 KB 级带宽浪费。
实操建议：
- 把最常出现、体积小的字段（
int32、bool、短string）优先分配 1–15 - 大字段（如
bytes、长string、嵌套message）可放 16+，反正它们本身体积主导开销 - 预留几个编号（如 10、11、12）给未来必加的通用字段（
trace_id、version） - 绝对不要跳着编号用（如只用 1、3、5），浪费编码空间
stream 方法返回值类型必须带 stream 关键字
定义流式接口时，stream 是语法必需词，不是修饰符。写成 rpc StreamUsers(StreamUsersRequest) returns (UserResponse); 不会报错，但生成的 Go 接口是普通一元调用，客户端收不到流；正确写法是：
rpc StreamUsers(StreamUsersRequest) returns (stream UserResponse);
对应生成的 Go 方法签名是：
func (s *server) StreamUsers(req *StreamUsersRequest, stream UserService_StreamUsersServer) error
其中 UserService_StreamUsersServer 是自动生成的流写入器，调用 Send() 才真正推数据。漏掉 stream 关键字，整个流式语义就失效了，而且 IDE 和静态检查几乎不会提示——这是最容易忽略也最难排查的问题之一。
