protoc生成代码必须同时包含pb.go和grpc.pb.go，且go_package需为完整模块路径并与go.mod一致；须同时指定--go_out和--go-grpc_out；服务端需嵌入unimplementedxxxserver；依赖版本须对齐。
protoc 生成的代码必须同时包含 pb.go 和 grpc.pb.go，缺一不可；否则服务注册或客户端调用会直接报错，比如 undefined: pb.RegisterGreeterServer 或 cannot use &server{} (type *server) as type pb.GreeterServer。
proto 文件里 service 定义必须带 option go_package
不写这行，protoc 会把生成的 Go 类型塞进默认包（通常是 main），导致 import 失败或类型不匹配。
常见错误写法：option go_package = ".;pb" 或 option go_package = "pb" —— 这些路径无法被 go build 正确解析。
正确写法必须是完整模块路径，且与 go.mod 中的 module 名一致：
option go_package = "github.com/yourorg/yourrepo/pb";- 路径末尾不加
.pb后缀 - Go 包名（
package pb）建议和路径最后一段一致，否则 import 时容易混淆 - 如果项目没开 Go modules，
go_package值必须能被go build在 GOPATH 下定位到
protoc 命令要同时指定 --go_out 和 --go-grpc_out
只跑 protoc --go_out=. 只会生成消息结构体（XXX.pb.go），没有 RegisterXXXServer、XXXClient 等 gRPC 接口代码，服务根本起不来。
必须两个输出都指定，并确保插件已安装：
在 Go 中使用 google/wire 实现编译时依赖注入——wire.NewSet、wire.Build、wire.Bind（接口→实现）、wire.Struct、wire.Value、wire.Interface
go install google.golang.org/protobuf/cmd/protoc-gen-go@latestgo install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest- 命令示例：
protoc --go_out=. --go_opt=paths=source_relative --go-grpc_out=. --go-grpc_opt=paths=source_relative service.proto -
--go_opt=paths=source_relative能让生成的import路径更干净，避免硬编码绝对路径
服务端实现必须嵌入 UnimplementedXXXServer
gRPC Go 生成的接口是“全量契约”，一旦 proto 新增 rpc 方法，旧 server 实现若没同步更新，又没嵌入未实现基类，运行时调用新方法就会 panic：unimplemented method XXX not found。
这不是编译错误，而是运行时崩溃，非常隐蔽。
- 在 server struct 里显式嵌入：
pb.UnimplementedGreeterServer - 不是继承，是 Go 的匿名字段嵌入：
type server struct{ pb.UnimplementedGreeterServer } - 即使当前没新增方法，也建议提前加上——这是防御性编码习惯
- 该基类由
protoc-gen-go-grpc自动生成，位于xxx_grpc.pb.go文件末尾
依赖版本必须对齐，尤其 google.golang.org/grpc 和 google.golang.org/protobuf
grpc-go v1.60+ 要求 protobuf v1.32+，低版本 protobuf 会导致 RegisterXXXServer 编译失败，报错类似：cannot use &server{} as type pb.XXXServer: missing method XXX。
这不是代码写错了，而是 runtime 接口签名不匹配。
- 检查
go list -m all | grep -E "(grpc|protobuf)" - 推荐锁定版本：
go get google.golang.org/grpc@v1.64.0+go get google.golang.org/protobuf@v1.34.2 - 不要混用
github.com/golang/protobuf（已废弃）和google.golang.org/protobuf（当前标准） - 生成代码时用的插件版本，最好和 runtime 依赖版本保持同 major
go mod tidy 是否拉齐了所有依赖，以及服务启动前没验证 protoc 输出路径是否和 import 路径完全一致——差一个斜杠或大小写，都会导致类型无法识别。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
