需安装新版 protoc-gen-go 并配置 go_package：运行 go install google.golang.org/protobuf/cmd/protoc-gen-go@latest，确保 $GOBIN 在 $PATH 中，.proto 文件顶部声明 option go_package = "github.com/yourorg/yourrepo/api/v1;v1"，调用时用 protoc --go_out=. --go_opt=paths=source_relative xxx.proto。
protoc 命令报 “plugin not found: go” 怎么办
这不是插件没装，而是新版 protoc（v24+）彻底移除了内置 protoc-gen-go 支持，必须显式安装并确保 PATH 可见。
- 运行
go install google.golang.org/protobuf/cmd/protoc-gen-go@latest安装（注意不是旧版github.com/golang/protobuf） - 确认
$GOBIN（通常是$GOPATH/bin）在$PATH中，执行which protoc-gen-go应返回路径 - 调用时必须写成
protoc --go_out=. --go_opt=paths=source_relative xxx.proto，--go_out后不能加冒号，否则 protoc 仍会认为插件缺失
生成的 .pb.go 文件 import 路径错乱或找不到包
根本原因不是 protoc -I 没设对，而是 .proto 文件里缺 go_package 声明，或声明与 Go module 路径不匹配。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 每个
.proto文件顶部必须有option go_package = "github.com/yourorg/yourrepo/api/v1;v1";—— 第一段是导入路径，第二段（分号后）是包名，可省略但建议显式写 - 如果项目用 Go modules，且模块路径是
github.com/yourorg/yourrepo，那go_package的前缀必须完全一致，否则生成的import "github.com/yourorg/yourrepo/api/v1"会编译失败 - 避免依赖
-M映射（如--go_opt=Mapi/v1/user.proto=...），它容易被覆盖、难维护，只在 Bazel 等构建系统中被动使用
GoLand 里点“Generate Code”没反应或生成空文件
GoLand 自带的 Protobuf 支持默认只识别老版 github.com/golang/protobuf 插件，对新版 google.golang.org/protobuf 不兼容，必须手动配置外部工具链。
- 打开 Settings → Tools → External Tools，新增一个工具：Program 填
protoc，Arguments 填--go_out=$ProjectFileDir$ --go_opt=paths=source_relative $FilePath$ - Working directory 设为
$ProjectFileDir$，确保.proto文件所在目录能被-I或go_package正确解析 - 不要勾选 “Synchronize files after execution”，否则可能因生成时机早于 GoLand 索引更新而显示为空；改用
Ctrl+Shift+O手动重载项目
自定义插件（比如 tarsrpc 或 http option）读不到扩展字段
扩展字段（如 (myapi.http_get) = "/v1/users"）默认不会加载进 protogen.File，直接类型断言会 panic。
- 确保
.proto中已import "myapi/options.proto"，且该文件本身也声明了正确的go_package - 初始化
protogen.Options时必须传入protogen.Option{ImportPath: "google.golang.org/protobuf/types/descriptorpb"}，否则无法 cast 到*descriptorpb.ServiceOptions - 读取前先判空：
if proto.HasExtension(service.Desc.Options(), myapi.E_HttpGet) {，再用proto.GetExtension(...)提取，否则 nil dereference - 字段级扩展要遍历
service.Methods[i].Input.Fields[j]，注意field.Desc返回的是protoreflect.FieldDescriptor，不是protogen.Field，需转 descriptor 后查 extension
go_package 与 module 路径的一致性、protoc-gen-go 的二进制可见性、以及扩展字段的显式加载逻辑——漏掉任一环，都可能静默失败。 
