Go 的 reflect 包是为特定元编程场景设计的窄接口，非通用动态类型工具；滥用会导致 panic、性能暴跌和调试困难，仅当编译期类型未知且无泛型替代时才应使用。
Go 的 reflect 包不是“通用动态类型工具”，而是为特定元编程场景设计的窄接口；滥用会导致 panic、性能暴跌和难以调试的错误。
什么时候必须用 reflect.TypeOf 和 reflect.ValueOf
只有当你无法在编译期确定类型，且标准库或第三方包未提供泛型替代方案时才需介入。典型场景包括：自定义 JSON 序列化钩子、ORM 字段映射、命令行参数绑定（如 urfave/cli 内部）、测试断言辅助函数。
-
reflect.TypeOf(x)返回reflect.Type，仅描述类型结构（如字段名、tag、方法集），不包含值 -
reflect.ValueOf(x)返回reflect.Value，携带值本身，但对不可寻址值（如字面量、函数返回临时值）调用.Set*会 panic - 若需修改原始变量，必须传入指针：
reflect.ValueOf(&x).Elem()，否则.CanSet()恒为false
reflect.Value.Interface() 的安全调用条件
该方法用于把反射值转回 interface{}，但有严格前提：值必须是可导出的（首字母大写字段），且不能是零值或未初始化的 reflect.Value。
- 从 struct 字段取值后，需先检查
v.CanInterface()，再调用v.Interface()，否则 panic - 对非导出字段（小写开头）调用
.Interface()会触发panic: reflect: call of reflect.Value.Interface on unexported field - 常见误用：直接对
reflect.ValueOf(struct{ x int }).FieldByName("x").Interface()调用 —— 即使字段存在，小写名也禁止导出
遍历 struct 字段并读取 tag 的正确姿势
这是最常被复制粘贴却错漏百出的操作。关键在于区分“类型层面”和“值层面”的 tag 获取。
立即学习“go语言免费学习笔记（深入）”；
- tag 属于类型定义，应从
reflect.TypeOf(t).Field(i).Tag读取，而非reflect.ValueOf(t).Field(i).Type().Field(i).Tag - 使用
tag.Get("json")提取值，注意它返回空字符串而非 error；若 tag 不存在或格式错误（如json:"name,缺少右引号），不会报错，只返回空 - 字段索引越界、匿名嵌入字段未展开、未导出字段不可见等问题，需配合
v.NumField()和v.Field(i).CanInterface()逐层校验
type User struct {
Name string `json:"name"`
age int `json:"age"` // 小写字段：Tag 可读，但无法通过反射取值
}
t := reflect.TypeOf(User{})
f, _ := t.FieldByName("age")
fmt.Println(f.Tag.Get("json")) // 输出 "age" —— Tag 本身可读
v := reflect.ValueOf(User{}).FieldByName("age")
fmt.Println(v.IsValid(), v.CanInterface()) // true false —— 值不可导出
反射的代价是明确的：每次 reflect.ValueOf 都有分配开销，Interface() 触发接口装箱，Call() 方法调用比直接调用慢 100 倍以上。真正需要它的点极少，而多数人试图用它绕过 Go 的类型系统约束 —— 那通常意味着设计该重构，而不是加反射。
