reflect无法直接读取结构体字段注解，因Go无运行时注解，标签仅为字符串，须手动调用field.Tag.Get("key")解析，且键名区分大小写、格式错误则返回空串。
为什么 reflect 无法直接读取结构体字段的注解
Go 语言本身不支持运行时注解（annotation），所谓“注解”实际是结构体字段标签（struct tag），它只是字符串，reflect 能读到，但不会自动解析。常见错误是写成 `json:"name" config:"required"` 却忘了用 structTag.Get("config") 手动提取，导致配置逻辑根本没触发。
关键点在于：标签必须显式解析，且键名区分大小写；空格、引号、逗号格式稍错就返回空字符串。
- 用
field.Tag.Get("config")获取原始字符串，不是field.Tag.Get("Config") - 若标签值含空格或特殊字符（如
config:"default=10,desc=timeout in ms"），需自行用strings.Split或正则解析 - 未设置该 tag 时
Get返回空字符串，不能直接strings.Split，应先判空
如何安全地从 struct tag 提取默认值并填充字段
直接修改反射值需满足可寻址（addr := reflect.ValueOf(&v).Elem()）和可设置（field.CanSet()）两个条件，否则 panic：reflect: reflect.Value.Set using unaddressable value。
典型场景是加载配置前，用 tag 中的 default 值预填充零值字段。
立即学习“go语言免费学习笔记（深入）”；
- 必须传入指针，再调用
.Elem()得到可设置的结构体值 - 遍历字段前检查
field.CanInterface()和field.CanSet()，避免对 unexported 字段赋值失败 - 类型要匹配：tag 里写
default:"true"，但字段是int，就不能直接field.Set(reflect.ValueOf("true")) - 推荐用
strconv或专用转换函数（如strconv.ParseBool）做类型适配，失败时跳过或记录 warn
if def := field.Tag.Get("config"); def != "" {
if strings.HasPrefix(def, "default=") {
valStr := strings.TrimPrefix(def, "default=")
if field.Kind() == reflect.String {
field.SetString(valStr)
} else if field.Kind() == reflect.Bool {
if b, err := strconv.ParseBool(valStr); err == nil {
field.SetBool(b)
}
}
}
}
如何避免反射配置在嵌套结构体中失效
嵌套结构体字段（如 DB ConfigDB `config:"group"`）的 tag 不会自动递归生效。如果只遍历一级字段，子结构体里的 default、required 等将被完全忽略。
必须手动递归处理：判断字段类型是否为 struct，若是，再调用同一套解析逻辑。
- 递归前加深度限制（如 ≤5），防止循环引用导致栈溢出
- 注意接口字段（
interface{}）或指针字段（*ConfigDB）需先.Elem()再判断 Kind - 嵌套时建议统一用小写 tag key（如
config），避免父级用config、子级用cfg导致逻辑割裂
为什么生产环境要慎用反射做配置校验
反射本身无性能问题，但高频调用（如每次 HTTP 请求都 reflect.StructOf）叠加字符串解析、类型转换，容易成为瓶颈。更隐蔽的问题是：编译期无法检查 tag 拼写错误，required:"ture"（拼错）会导致必填项永远不生效。
真实项目中，建议只在初始化阶段（如 main() 开头）做一次反射配置加载，后续全部走普通变量访问；校验逻辑可导出为独立函数，用单元测试覆盖 tag 解析分支。
最容易被忽略的是：反射无法捕获字段是否被外部代码意外修改——比如某处写了 c.Timeout = 0，而你的 required 校验只跑在启动时，之后就再不检查了。
