go配置解析不靠反射读字段，而是用标准库unmarshal配合struct tag；错误做法是手动reflect.value.set，正确做法是根据文件后缀选择yaml/json.unmarshal并传指针，避免依赖name()判类型，优先用mapstructure或缓存reflect.type优化性能。
反射怎么把 YAML/JSON/TOML 文件自动塞进 struct
靠 reflect.StructTag 和 Unmarshal 组合，不是靠反射自己去读字段值。Go 的标准库解码器（比如 yaml.Unmarshal、json.Unmarshal）本身已支持通过 struct tag 映射字段，反射只在「动态决定用哪个解码器」或「统一入口分发」时才真正介入。
常见错误是试图用 reflect.Value.Set 一行行赋值——既慢又容易 panic，还绕过类型检查和 tag 解析逻辑。
- 先定义带
yaml、json等 tag 的 struct，例如type Config struct { Port int `yaml:"port"` } - 用
ioutil.ReadFile或os.ReadFile读出字节流，不解析成字符串再转，避免编码问题 - 根据文件后缀选解码器：
if strings.HasSuffix(path, ".yaml") { yaml.Unmarshal(data, &cfg) }，别用反射去“猜”格式 - 所有解码器都要求目标变量是指针，传
&cfg而非cfg，否则静默失败
为什么用 reflect.TypeOf(cfg).Name() 判断 struct 类型会失效
因为 reflect.TypeOf 返回的是运行时类型描述，而匿名嵌入、指针间接、接口包装都会让 Name() 返回空字符串或意外名称。比如 *Config 的 Name() 是空，struct{...} 根本没名字。
真正可靠的判断方式是：用 reflect.Indirect(reflect.ValueOf(cfg)).Kind() == reflect.Struct 确认它是可解码的结构体，再用 reflect.TypeOf(cfg).Elem().Name()（如果 cfg 是指针）取原始名。
立即学习“go语言免费学习笔记（深入）”；
- 别依赖
Name()做配置路由，改用显式传入类型标识，比如函数加个format string参数 - 如果必须识别 struct 类型，优先用
reflect.TypeOf(cfg).String()做调试输出，它比Name()更稳定 - 嵌入 struct 时，tag 不会自动继承，
yaml:",inline"这种写法必须显式声明，反射不会帮你补
map[string]interface{} 转 struct 为什么总 panic: reflect: call of reflect.Value.Interface on zero Value
这是典型未初始化导致的 panic。从 yaml.Unmarshal 或 json.Unmarshal 得到的 map[string]interface{}，若某字段缺失或为 null，对应 value 就是零值，reflect.ValueOf(val) 返回的是 invalid Value，调用 .Interface() 就崩。
正确做法是先用 reflect.Value.IsValid() 检查，再判断 .Kind() 是否为 reflect.Map 或 reflect.Struct，而不是直接强转。
- 别写
v := reflect.ValueOf(m[key]); v.Interface().(string)，先if !v.IsValid() { continue } - 用
mapstructure.Decode替代手写反射映射，它内部已处理 null/missing/类型转换等边界 - 如果坚持用反射，对每个字段做
field.CanSet() && field.Kind() == targetField.Kind()双重校验，避免越界赋值
性能敏感场景下，反射解析配置要不要缓存 reflect.Type 和 reflect.Value
要缓存 reflect.Type，但别缓存 reflect.Value。Type 是只读元信息，复用安全；Value 绑定具体实例，带状态，缓存后可能引发并发写冲突或 stale pointer 问题。
实际项目中，配置加载通常是启动期一次性行为，性能瓶颈往往不在反射本身，而在文件 I/O 或正则匹配 tag。但如果高频热更新配置（比如 watch + reload），缓存 Type 可减少约 15–20% 的 CPU 时间。
- 用
sync.Once初始化全局typeCache map[reflect.Type]fieldInfo，key 是reflect.TypeOf(&T{}).Elem() - 别缓存
reflect.ValueOf(&cfg).Elem()，每次 reload 都应新建 Value 实例 - 注意：
reflect.Type在包内相同 struct 下是同一实例，但跨包（如 vendor 复制）可能不同，缓存前建议加String()校验
最常被忽略的是 tag 解析开销——每次调用 reflect.StructTag.Get 都会做字符串切分。如果 struct 字段多，提前把 tag 提取到 slice 里复用，比反复调用 Get 快一倍以上。
