直接解析Go源码AST比依赖OpenAPI或Protobuf IDL更可靠，因其能100%保留字段标签、嵌套结构、方法接收者及//+kubebuilder等关键注释，避免类型映射失真、注释丢失和嵌套展开错误。
为什么直接 parse 源码比读取接口定义更可靠
Go 微服务骨架生成如果依赖 OpenAPI 或 Protobuf IDL，常卡在类型映射失真、注释丢失、嵌套结构展开错误上。AST 直接解析 go/ast 树，能 100% 保留原结构：字段标签、嵌套 struct 层级、方法接收者类型、甚至 //+kubebuilder 这类标记注释——这些是生成 gRPC Server、HTTP handler、CRD 定义的关键依据。
- 用
go/parser.ParseFile读取types.go，不是靠正则或 JSON Schema 猜测结构 - 遍历
*ast.TypeSpec时，用ast.Inspect比递归访问更稳，避免漏掉匿名字段或嵌套 interface - 注意
go/types.Info需要完整 build context，纯 AST 不带语义，但对骨架生成已足够；若需类型别名展开（如type UserID int64），才必须补go/types
如何提取 struct 字段并映射到 gRPC message 字段
目标不是把 Go struct 一字不差转成 proto，而是生成可编译的 .proto 内容，同时保留字段顺序、必选/可选语义、以及常见 tag 如 json:"user_id" 和 validate:"required"。
- 遍历
*ast.StructType.Fields.List，每个*ast.Field的Names取第一个标识符（忽略匿名字段的空名） - 用
ast.String解析field.Tag，调用reflect.StructTag.Get("json")提取 key，再按_分割转为 PascalCase 作为 proto 字段名（如user_id→UserId） - 基础类型映射要硬编码：
int64→int64，time.Time→google.protobuf.Timestamp，[]string→repeated string；切片和指针需单独判断ast.StarExpr和ast.ArrayType - 遇到未识别类型（如自定义 enum）直接跳过该字段，打 warning 日志，不 panic —— 骨架代码宁可少字段，不能错生成
生成 HTTP handler 时怎么处理路由与参数绑定
AST 能看到函数签名和注释，但看不到 HTTP 方法和路径。所以必须约定注释格式，比如 // @POST /v1/users，然后在遍历 *ast.FuncDecl 时提取。
- 只处理接收者为
*Server且参数含context.Context和*http.Request的函数（排除 test helper） - 用正则匹配注释行：
// @([A-Z]+) ([^\s]+)，捕获 method 和 path；没匹配到就默认为GET /{struct_name}/{func_name} - 从
func (*Server) CreateUser(ctx context.Context, req *CreateUserRequest) error推导出：body 绑定req类型，query 参数从req字段 tag 中找form:"name"，header 从header:"X-Trace-ID"提取 - 生成的 handler 函数体里，用
json.NewDecoder(r.Body).Decode(&req)而不是encoding/json.Unmarshal—— 前者支持 streaming，后者会全量读内存，微服务里容易 OOM
为什么生成的代码必须包含 go:generate 注释
AST 生成是一次性的，但 proto 编译、gRPC stub 生成、swagger 文档更新是持续动作。把构建逻辑锚定在源码里，比维护 Makefile 更可靠。
立即学习“go语言免费学习笔记（深入）”；
- 在生成的
api/v1/service.pb.go上方写：//go:generate protoc -I=. --go_out=. --go-grpc_out=. service.proto - 在主
main.go里加：//go:generate go run ./cmd/gen-swagger，让 swagger.json 始终和当前 AST 结果一致 - 注意
go:generate不递归执行，所以所有子命令必须显式声明依赖项，比如protoc二进制必须在 PATH 中，否则go generate会静默失败 - CI 中跑
go generate后做git diff --quiet，有变更就 fail —— 防止手改生成文件导致下次生成冲突
真正难的不是遍历 AST，而是决定哪些信息该丢、哪些该留、哪些要强制约定。比如 struct 字段顺序要不要保持，proto 的 package 名怎么从 import path 推导，这些细节没标准答案，得看团队协作成本。
