必须使用protogen.options.run，因其封装了codegeneratorrequest解析、parameter校验、supported_features设置及文件过滤逻辑；跳过会导致漏文件、重复写入或自定义选项失效。
直接上结论：自定义 Protobuf 插件不是“写个模板再渲染”，而是必须严格遵循 protoc 与插件之间的二进制协议，且 protogen.Options.Run 是唯一安全入口——跳过它，90% 的插件会在多文件、带扩展、含 optional 字段的场景下静默失败或漏生成。
为什么 protogen.Options.Run 不可跳过
Protobuf 插件协议要求插件必须完整处理 CodeGeneratorRequest 的解析、参数校验、feature 支持声明和文件过滤。手动读 os.Stdin 再 proto.Unmarshal 看似可控，但极易出错：
- 忽略
parameter字段 → 自定义选项（如--myplugin_opt=debug）完全失效 - 未设置
gen.SupportedFeatures→proto3 optional字段生成失败，protoc报错Feature not supported - 没调用
gen.Files[i].Generate = true→ 部分.proto文件被跳过（尤其当它们是依赖项而非主输入时） - 未做
files.Filter→ 同一 proto 在多个--xxx_out调用中重复生成，覆盖或冲突
protogen.Options.Run 封装了全部这些逻辑，且会自动注入 protogen.File 中已解析的扩展信息（前提是正确配置 import 路径）。
如何在 generateFile 中安全读取扩展字段
扩展信息（比如 (myapi.http_get) = "/v1/users"）默认不加载，必须显式启用并小心类型转换：
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 确保
.proto文件 import 了定义扩展的文件，例如import "myapi/options.proto"; - 在
protogen.Options初始化时传入protogen.Option{ImportPath: "google.golang.org/protobuf/types/descriptorpb"}（否则无法 cast 到*descriptorpb.ServiceOptions） - 对每个
*protogen.Service，先用proto.HasExtension(service.Desc.Options(), myapi.E_HttpGet)判断是否存在，再用proto.GetExtension(service.Desc.Options(), myapi.E_HttpGet)提取值 - 字段级扩展要遍历
service.Methods[i].Input.Fields[j]，注意field.Desc返回的是protoreflect.FieldDescriptor，不是protogen.Field；需转成protoreflect.Descriptor后再查 options
类型断言失败或未判空会导致 panic，务必加 if x, ok := ...; ok。
插件找不到或报 “program not found” 怎么办
这是最常卡住新人的问题，根本原因只有两个：PATH 和命名规则不匹配。
-
protoc只查$PATH下名为protoc-gen-xxx的可执行文件，不会看$GOBIN或当前目录 -
--xxx_out=.中的xxx必须和二进制名严格一致：想用--myapi_out=.，二进制必须叫protoc-gen-myapi - 执行
which protoc-gen-myapi必须有输出；没有就go install ./cmd/protoc-gen-myapi并确认$GOBIN在$PATH中 - 临时调试可用
--plugin=protoc-gen-myapi=/abs/path/to/protoc-gen-myapi绕过 PATH 查找
错误信息只能写到 os.Stderr；往 os.Stdout 打任何日志都会让 protoc 解析失败，表现为“无输出但也不报错”。
真正难的不是生成代码，而是让插件在任意规模项目里稳定跑通：多层 import、跨模块 go_package、proto edition 切换、optional 字段共存——这些边界情况，全靠 protogen.Options.Run 和正确的 descriptor 解析路径兜底。漏掉任一环，生成结果就不可靠。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
