必须在proto文件中添加option go_package，其值为完整导入路径（如"github.com/yourorg/yourrepo/pb"），且需与go.mod中module名一致；grpc service方法须用rpc method(request) returns (response)格式声明，请求/响应类型必须是已定义的message；生成go grpc代码需同时使用--go_out和--go-grpc_out，并安装protoc-gen-go-grpc；server实现必须嵌入unimplementedxxxserver以避免新增rpc导致panic。
proto 文件里写 service 必须加 option go_package
不加这行，protoc 生成 Go 代码时会把服务接口塞进默认包（比如 main），导致编译报错 undefined: pb.XXXServiceServer 或找不到类型。
-
option go_package的值必须是完整导入路径，比如"github.com/yourorg/yourrepo/pb"，不是相对路径，也不是空字符串 - 路径末尾不要带
.pb后缀；Go 包名可以和路径最后一段不同，但强烈建议保持一致，否则 import 时容易混淆 - 如果项目用了 Go modules，这个路径必须和
go.mod声明的 module 名能对上，否则go build找不到包
gRPC service 定义要显式指定 rpc + 类型签名，不能只写函数名
常见错误是照着 REST 或普通函数习惯写，比如 GetUser(int32) User，这在 proto 里完全无效，protoc 直接报语法错。
- 每个方法必须以
rpc 方法名 (请求类型) returns (响应类型);格式声明 - 请求/响应类型必须是已定义的
message，不能是基础类型（如int32、string）或未声明的类型 - 流式方法要明确写
stream关键字：单向流用rpc StreamIn(stream Req) returns (Resp)，双向流用rpc Bidirectional(stream Req) returns (stream Resp)
生成 gRPC Go 代码得用 --go-grpc_out，且依赖 grpc-go 运行时
只用 --go_out 只会生成普通结构体和 Marshal/Unmarshal 方法，不会生成 RegisterXXXServer、XXXClient 等 gRPC 接口相关代码。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 命令要带两个输出插件：
protoc --go_out=. --go-grpc_out=. your_service.proto -
--go-grpc_out默认要求安装protoc-gen-go-grpc，Go 1.16+ 推荐用go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest - 生成的代码依赖
google.golang.org/grpc和google.golang.org/protobuf，版本需匹配——常见坑是grpc-go v1.60+要求protobuf v1.32+，否则RegisterXXXServer编译失败
server 实现必须嵌入 UnimplementedXXXServer，否则新字段扩展会 panic
如果你的 service 接口后续加了新 rpc 方法，而旧 server 实现没更新，又没嵌入未实现基类，运行时调用新方法会直接 panic：unimplemented method XXX not found。
- 正确写法：
type MyServer struct { pb.UnimplementedUserServiceServer } - 不嵌入的话，哪怕你只实现了一个
GetUser，只要 proto 里新增了UpdateUser，客户端一调就崩 - 这个基类是 protoc 自动生成的，名字格式为
Unimplemented{ServiceName}Server，大小写严格匹配
最常被跳过的其实是 option go_package 的路径一致性——它不报错，但会导致生成的代码散落在错误包里，import 时看似成功，实际类型不识别。调试时翻半天 pb 目录才发现包路径和 go.mod 对不上。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
