go反射获取结构体字段需用reflect.structtag解析标签，递归展开嵌套匿名字段，校验指针有效性，且必须缓存type元数据避免性能损耗。
Go反射获取结构体字段名和标签值必须用reflect.StructTag解析
直接读field.Tag返回的是原始字符串，比如`gorm:"column:id;primaryKey"`，不解析就无法提取column或primaryKey。必须调用tag.Get("gorm")再用strings.Split或正则拆解，否则所有ORM映射逻辑都会失效。
常见错误是把field.Tag当map用：field.Tag["column"]会panic——Go的tag不是map类型。正确做法是：
tag := field.Tag.Get("gorm")
if tag != "" {
// 解析 "column:id;primaryKey;type:int"
parts := strings.Split(tag, ";")
for _, part := range parts {
kv := strings.SplitN(part, ":", 2)
if len(kv) == 2 {
key, val := strings.TrimSpace(kv[0]), strings.TrimSpace(kv[1])
// key=="column", val=="id"
}
}
}
嵌套结构体字段不能靠reflect.Value.Field(i)直接取值
如果结构体里嵌了匿名字段（如type User struct { BaseModel; Name string }），reflect.Value.Field(i)只返回一级字段，不会自动展开BaseModel里的ID、CreatedAt等。ORM需要扁平化字段列表，必须递归遍历。
实操建议用栈或队列手动展开：
- 初始化时把
reflect.TypeOf(struct{}).Field(i)入队 - 对每个字段检查
Anonymous为true且Type.Kind() == reflect.Struct - 如果是，则把其所有导出字段再推入队列
- 跳过非导出字段（
field.PkgPath != ""）
漏掉这一步，继承自基类的ID字段在INSERT语句里就彻底消失了。
reflect.Value.Interface()在指针场景下容易panic
ORM通常接收*User做参数，但调用reflect.ValueOf(ptr).Elem()后，如果原指针是nil，Elem()会直接panic。更隐蔽的问题是：对nil接口值调用Interface()也会panic。
安全写法必须加两层判断：
v := reflect.ValueOf(ptr)
if v.Kind() == reflect.Ptr && v.IsNil() {
return errors.New("nil pointer passed to ORM")
}
v = v.Elem()
if !v.IsValid() {
return errors.New("invalid struct value")
}
// 此时才能遍历v.NumField()
另外，字段值如果是nil指针（如*string字段未赋值），v.Field(i).Interface()仍会返回nil，但SQL生成时需转成NULL——这个转换逻辑不能依赖反射自动完成，得在字段解析阶段就记录类型是否可空。
性能敏感场景下避免每次查询都反射结构体
反射开销大，尤其在高频INSERT/UPDATE中反复调用reflect.TypeOf和reflect.ValueOf，会导致GC压力上升、CPU缓存失效。实际项目必须缓存解析结果。
推荐用sync.Map按reflect.Type做键缓存字段元数据：
var typeCache sync.Map // map[reflect.Type]*structMeta
type structMeta struct {
Columns []columnInfo
PKField *fieldInfo
}
注意：不能用reflect.Type.Name()当key，因为同名但不同包的结构体（如model.User和api.User）Type不相等但Name相同；必须用reflect.Type本身作key。
缓存没加锁或用错key是线上OOM的常见原因——反射对象本身不占多少内存，但缓存里存了大量reflect.StructField副本，且永不释放。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
