protoc-gen-go 和 protoc-gen-go-grpc 必须成对安装且版本一致，仅生成结构体和接口，需手动补全服务注册与路径对齐；go_package 必须写为 "path;name" 格式，--go_out 和 --go-grpc_out 需分两次指定，生成后必须调用 RegisterXXXServer 才能启用服务。
不能只装插件就以为能跑通——protoc-gen-go 本身不生成服务逻辑，也不注册服务，它只输出结构体和空接口；真正让接口活起来的，是后续的手动补全和路径对齐。
protoc-gen-go 和 protoc-gen-go-grpc 必须成对安装且版本一致
这两个插件不是可选组合，而是硬性依赖关系。v1.30+ 的 protoc-gen-go-grpc 已彻底放弃兼容旧版 protoc-gen-go，混用会导致生成代码缺失 RegisterXXXServer 函数，或 .pb.go 与 _grpc.pb.go 包路径错乱。
- 必须执行两条 install 命令（顺序无关）：
go install google.golang.org/protobuf/cmd/protoc-gen-go@latestgo install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest - 验证是否生效：
protoc-gen-go --version和protoc-gen-go-grpc --version都应输出v1.30.x或更高 - 如果提示
command not found，不是没装成功，而是$GOBIN（默认为$HOME/go/bin）没进PATH；别用go run临时调用——protoc只认 PATH 里的可执行文件
go_package 必须写成 "./subdir;pkgname" 格式
option go_package 不是注释，它直接决定生成文件的存放位置和包名。写成 option go_package = "user" 看似简洁，但会让 protoc-gen-go 把代码生成到当前目录、包名设为 user，而实际项目结构可能是 proto/user/v1/user.proto，导致 go build 找不到包。
- 正确写法示例：
option go_package = "proto/user/v1;userv1"; - 含义：
proto/user/v1是相对输出路径（配合--go_opt=paths=source_relative），userv1是 Go 包名 - 生成后，
user.pb.go会落在./proto/user/v1/目录下，开头是package userv1 - 若 proto 文件在
api/auth/auth.proto，就该写option go_package = "api/auth;auth"，不能省略路径部分
--go_out 和 --go-grpc_out 必须分两次指定，不能合并
老教程里常见的 --go_out=plugins=grpc:. 在 v1.26+ 已被移除，继续用会报错 --go_out: protoc-gen-go: plugins are not supported。新版要求明确分离消息定义和服务接口生成。
立即学习“go语言免费学习笔记（深入）”；
- 正确命令模板：
protoc --go_out=. --go_opt=paths=source_relative \--go-grpc_out=. --go-grpc_opt=paths=source_relative \api/user/v1/user.proto -
--go_out=.只生成user.pb.go（含 message 结构体、Marshal/Unmarshal 方法） -
--go-grpc_out=.单独生成user_grpc.pb.go（含UserServiceClient、UserServiceServer接口、RegisterUserServiceServer函数） - 漏掉
--go-grpc_out，你就只有数据结构，没有 RPC 接口；漏掉--go_out，连HelloRequest都没定义，_grpc.pb.go会编译失败
生成代码后必须手动注册服务，否则返回 UNIMPLEMENTED
protoc-gen-go-grpc 生成的 RegisterXXXServer 是纯函数，不会自动注入。如果你只写了 &UserServiceImpl{} 却没调用注册函数，gRPC server 启动时完全感知不到这个服务存在。
- 典型错误写法：
server := grpc.NewServer()// 忘了 RegisterUserServiceServer(server, &UserServiceImpl{}) - 正确流程：
server := grpc.NewServer()pb.RegisterUserServiceServer(server, &UserServiceImpl{})lis, _ := net.Listen("tcp", ":8080")server.Serve(lis) - 如果用了 TLS 或拦截器，必须提前传入
grpc.NewServer(grpc.Creds(...), grpc.UnaryInterceptor(...))，不能靠生成代码自动带进去 - 客户端调用时若收到
rpc error: code = Unimplemented，90% 是这一步漏了
最常被跳过的其实是 go_package 路径和 RegisterXXXServer 调用这两处——它们不报编译错误，却让整个服务静默失效。生成代码只是起点，不是终点。
