用 reflect.typeof 获取结构体类型后遍历 numfield，取 field(i).name 得字段名；需传值或指针避免 interface{} 丢失类型，跳过私有字段（pkgpath != ""），仅补全 string 或 textunmarshaler 类型字段，支持 json/yaml 标签映射，嵌入字段按需递归但限深度，泛型具化后正常处理。
Go reflect 怎么拿到结构体字段名做补全
直接用 reflect.TypeOf 拿到结构体类型，再遍历 NumField，逐个取 Field(i).Name 即可。注意必须传入指针或值本身（不能是 interface{} 包装后丢掉类型信息），否则 reflect.TypeOf 返回的是 interface{} 类型，看不到原始字段。
常见错误：传了 interface{} 变量进去，比如 var v interface{} = MyStruct{}; reflect.TypeOf(v) → 得到的是 interface{}，不是 MyStruct。要改用 reflect.TypeOf(MyStruct{}) 或 reflect.TypeOf(&v).Elem()（如果 v 是指针）。
- 字段名默认是首字母大写的导出名；想用
json标签替代，得手动查Tag.Get("json") - 如果结构体嵌套了匿名字段，
Field(i).Anonymous为 true，要不要展开看需求——命令行补全通常不展开，避免歧义 -
reflect.ValueOf(x).Type()和reflect.TypeOf(x)效果一样，但前者多一次反射开销，没必要
补全时怎么过滤掉非字符串字段
命令行提示补全字段名，本质是让用户输字段前缀后按 Tab，所以只该展示能“赋值成字符串”的字段（比如用于配置项、查询条件）。其他类型如 int、bool、自定义 struct，补全后没法直接输入值，反而干扰。
判断逻辑很简单：用 Field(i).Type.Kind() 看底层类型，只留 string，或者支持 TextUnmarshaler 的类型（比如 time.Time，但实际中很少对它做字段级补全）。
立即学习“go语言免费学习笔记（深入）”；
-
Kind()返回的是基础类型，String()、Int()、Bool()等，别用Name()去比对 - 别忘了跳过私有字段：
Field(i).PkgPath != ""表示未导出，这种字段外部不可设，补全出来没意义 - 如果字段是
*string，Kind()是Ptr，得用Elem()再取一次才得到String—— 但一般不建议补全指针字段名，容易混淆
为什么 gocomplete 或 spf13/cobra 不直接支持结构体字段补全
因为补全行为依赖上下文：你当前在解析哪个结构体？字段是否允许空？有没有自定义验证逻辑？这些无法靠通用框架静态推断。所以像 cobra 的 ValidArgsFunction 必须自己写，把结构体类型作为闭包变量传进去。
典型做法是注册一个函数，接收当前输入前缀和命令对象，内部用 reflect 扫描目标结构体，返回匹配的字段名切片：
cmd.RegisterFlagCompletionFunc("config", func(cmd *cobra.Command, args []string, toComplete string) ([]string, cobra.ShellCompDirective) {
var cfg Config
return completeStructFields(cfg, toComplete), cobra.ShellCompDirectiveNoFileComp
})
- 别在补全函数里做 heavy reflection（比如每次都
reflect.TypeOf(cfg)+ 全量扫描）——可以提前缓存字段名列表 - 如果结构体字段带
yaml或mapstructure标签，而 CLI 用的是json名，补全时得统一用标签值，不是Name -
toComplete是用户已输入的部分，区分大小写；字段名补全建议全小写匹配，但返回原始大小写字段名（Go 字段名就是大驼峰）
字段补全遇上嵌入结构体和泛型怎么办
嵌入结构体（anonymous struct field）会让字段“平铺”进当前结构体，reflect 默认不会自动展开。想支持类似 User.Name 这种点号路径补全，得递归处理，但命令行交互中极少需要——用户更习惯一次性看到顶层字段，而不是树状路径。
泛型结构体（如 type Opt[T any] struct { Value T }）在运行时类型已具化，reflect.TypeOf(Option[string]{}) 能正常拿到字段，但 T 会被擦除成具体类型，不用额外处理。
- 嵌入字段若想参与补全，需显式检查
Field(i).Anonymous && Field(i).Type.Kind() == reflect.Struct，再递归扫描——但务必加深度限制（比如最多 2 层），否则可能栈溢出或列出太多无关字段 - 泛型代码里如果用了
any或interface{}字段，Kind()会是Interface，这种字段无法安全补全，跳过最稳妥 - 别试图在补全里支持方法名、嵌套 map key 或 slice index——那已经超出字段补全范畴，属于 DSL 解析了
真正难的不是反射本身，而是补全时机和上下文绑定：同一结构体，在不同子命令里可能只开放部分字段；字段是否可空、是否有默认值、是否被标记为 deprecated，这些信息都得从 tag 或外部规则里捞，reflect 只负责打开结构体这扇门，门后怎么组织，得你自己定规矩。
