必须使用protogen.Options.Run，因其封装了CodeGeneratorRequest解析、parameter校验、supported_features设置及文件过滤逻辑；跳过会导致漏文件、重复写入或自定义选项失效。
能直接复用 protogen.Plugin，不用从零解析 CodeGeneratorRequest；但必须理解插件启动时的生命周期和文件过滤逻辑，否则生成的代码会漏文件或重复写入。
为什么不能跳过 protogen.Options.Run 直接读 stdin
Protobuf 插件协议要求插件必须按标准流程响应：接收 CodeGeneratorRequest、校验参数、返回 CodeGeneratorResponse。手动读 stdin 写 stdout 容易出错，比如：
- 忽略
parameter字段导致自定义选项（如--myplugin_opt=xxx）无法传入 - 没处理
supported_features，导致 proto3 optional 字段生成失败 - 未正确设置
gen.Files的Generate标志，使部分.proto被跳过 - 忘记调用
gen.SupportedFeatures = uint64(...)，触发 protoc 报错Feature not supported
官方 protogen 包已封装好这些细节，protogen.Options.Run 是唯一推荐入口。
generateFile 里怎么拿到服务/方法/字段的扩展信息
扩展信息（如 (myapi.http_get) = "/v1/users"）不是默认加载的，必须显式启用依赖描述符并解析。关键步骤是：
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 在
protogen.Options初始化时传入protogen.Option{ImportPath: "google.golang.org/protobuf/types/descriptorpb"}（如果要用descriptorpb类型） - 确保
.proto文件 import 了定义扩展的.proto，例如import "myapi/options.proto"; - 在
generateFile中对每个*protogen.Service调用service.Desc.Options().(*descriptorpb.ServiceOptions)，再用proto.GetExtension提取值 - 字段级扩展需遍历
field.Desc.Options()，注意field.Desc返回的是protoreflect.FieldDescriptor，不是protogen.Field
漏掉 import 或类型断言失败会导致 panic，建议用 proto.HasExtension 先判断。
--myplugin_out=. 生成路径和包名怎么控制
输出路径由 --myplugin_out 后的参数决定，但最终文件写入位置和 Go 包声明受两个因素控制：
-
file.GoPkg.Path决定生成文件的package xxx声明，它来自.proto中的go_package选项；没设则 fallback 到file.Desc.Path()（即.proto文件路径） -
file.GeneratedFilename默认是file.GoPkg.Path + ".myplugin.go"，但可通过gen.NewGeneratedFile(filename, file.GoPkg)覆盖 - 若想让生成文件和
.proto同目录（如user.proto → user.myplugin.go），需用filepath.Base(file.Desc.Path())拼接，并确保go_package正确指向该目录的模块路径 - 错误配置会导致
import "xxx" not found或编译器报package xxx; expected xxx
别硬编码路径拼接，优先用 file.GoPkg 和 gen.NewGeneratedFile 组合，这是唯一能与 Go Modules 兼容的方式。
调试插件时 stderr 不显示、生成文件为空的常见原因
protoc 运行插件时会捕获 stderr 并吞掉，除非插件进程 panic 或 exit code 非 0。空文件通常意味着：
-
gen.Files循环里没调用gen.NewGeneratedFile，或调用后没写内容（g.P(...)必须执行） -
file.Generate为 false，常见于.proto文件没被 protoc 显式指定（如只写了protoc --myplugin_out=. a.proto，但a.protoimport 了b.proto，而b.proto不在命令行列表中） - 插件二进制没加可执行权限（Linux/macOS 下
chmod +x必须） - Go 模块未初始化（
go mod init缺失）导致protogen包版本冲突，静默失败
最有效的调试方式是：先在 main 函数开头加 log.Println("plugin started")，然后用 protoc --plugin=protoc-gen-myplugin=./myplugin --myplugin_out=. a.proto 2>&1 查看原始输出——stderr 真的会被重定向到终端。
