Go反射在动态配置中易因类型误判、字段不可导出或可设置性缺失导致静默失败或panic；必须传指针并检查CanSet()，解析tag需验证非空，nil指针需先判空。
Go语言反射在动态配置场景中不是“能用就行”，而是极易因类型误判、字段不可导出或可设置性缺失，导致配置加载静默失败或 panic。
reflect.ValueOf 传入值类型而非指针时无法修改字段
配置结构体通常通过 JSON/YAML 解析后赋值，但若你试图用反射批量填充字段却传了值类型（如 reflect.ValueOf(config)），后续调用 SetXxx() 会直接 panic 或无效果。
- 必须传指针：
reflect.ValueOf(&config)，再调用Elem()获取可设置的reflect.Value - 常见错误现象：
v.CanSet() == false，即使字段是导出的，值类型本身不可寻址 - 性能影响：传值会触发结构体拷贝，大结构体下开销明显；指针则零拷贝
忽略字段导出性与可设置性检查
Go 反射严格遵循导出规则：只有首字母大写的字段才可通过反射读写。但更隐蔽的问题是，即使字段导出，若反射值不可设置（CanSet() == false），SetString() 等操作会静默失败或 panic。
- 务必在调用
SetXxx()前检查：if !v.CanSet() { return fmt.Errorf("field %s is not settable", field.Name) } - 常见误操作：对嵌套结构体字段直接
v.FieldByName("Inner").FieldByName("Name")，中间某层若为值类型（非指针），最终CanSet()返回 false - 建议统一用
reflect.Indirect(v)处理可能的指针嵌套，再判断可设置性
配置字段 tag 解析错误导致映射错位
动态配置常依赖 struct tag（如 json:"host"、env:"DB_HOST"）做键名匹配。但 reflect.StructTag 的 Get() 方法对空 tag 或非法格式不报错，只返回空字符串，容易造成字段漏设。
立即学习“go语言免费学习笔记（深入）”；
- 不要直接信任
field.Tag.Get("json")的返回值；应先检查是否非空：tag := field.Tag.Get("json"); if tag == "" { continue } - 注意 tag 值可能含选项，如
json:"port,omitempty"，需用strings.Split(tag, ",")[0]提取主键名 - 兼容性风险：不同配置源（TOML/YAML/ENV）使用不同 tag key，若未做统一抽象，切换格式时易出错
反射遍历结构体时 panic: call of reflect.Value.NumField on zero Value
这是最常被忽略的初始化陷阱：当配置变量本身为 nil 指针（如 var cfg *Config 未初始化），reflect.ValueOf(cfg).Elem() 会返回零值 reflect.Value，此时调用 NumField() 直接 panic。
- 安全做法：先判断是否为 nil：
if v.Kind() == reflect.Ptr && v.IsNil() { return errors.New("config pointer is nil") } - 更稳妥方式：用
reflect.Indirect(v)替代裸v.Elem()，它会自动跳过 nil 指针并返回零值，再配合IsValid()判断 - 这个 panic 很难在单元测试中暴露——只有真实配置为空或未注入时才触发
