应使用db标签并显式解析，如ID int64 \db:"id"\`；遍历字段前须用field.CanInterface()判断导出性；取值需按Kind()分支处理，避免直接断言；高频场景须缓存reflect.Type`级元信息。
struct标签怎么写才让反射能正确提取数据库字段名
Go 的 reflect 包本身不解析 struct 标签，必须手动调用 StructField.Tag.Get("xxx")。常见错误是直接用 field.Name 当作列名，结果插入时字段全错。
推荐统一用 db 标签，例如：
type User struct {
ID int64 `db:"id"`
Name string `db:"name"`
Age int `db:"age,omitempty"` // omitempty 可用于 INSERT 忽略零值字段
}
- 避免混用
json、gorm等其他框架标签，防止语义冲突 -
omitempty不是反射自动识别的，需在你自己的 ORM 解析逻辑里显式判断strings.Contains(tag, "omitempty") - 空标签（如
db:""）会导致字段名 fallback 到结构体字段名，容易引发大小写不一致问题（比如 PostgreSQL 默认小写）
如何用反射安全地遍历结构体字段并跳过非导出字段
反射无法读取非导出字段（首字母小写），强行访问会 panic 或返回零值。很多 ORM 实现漏掉这个检查，导致 nil pointer dereference 或静默丢字段。
- 必须先用
field.CanInterface()或field.PkgPath != ""判断是否导出 - 别依赖
field.IsExported()—— 它只对 struct field 有效，对嵌套指针或 interface 内部字段无效 - 嵌套结构体（如
Address *Address）要递归处理，但需防循环引用：建议用map[reflect.Type]struct{}记录已访问类型 - 切片、map、interface{} 类型字段应跳过，除非你明确支持 JSON 列或序列化存储
反射获取字段值时为什么常出现 interface{} 转换失败
调用 field.Interface() 返回的是 interface{}，但底层可能是指针、nil 接口、未初始化的 struct 字段。直接强制类型断言（如 v.(string)）极易 panic。
立即学习“go语言免费学习笔记（深入）”；
- 优先用
field.Kind()分支判断：比如field.Kind() == reflect.String再取field.String() - 对指针字段（
field.Kind() == reflect.Ptr），先field.Elem()再判断是否 valid，否则Elem()会 panic - 时间类型（
time.Time）需特殊处理：它底层是 struct，不能直接field.Interface().(time.Time)，应统一用field.Interface()后断言为time.Time（因为time.Time是导出类型） - 零值字段（如 int=0、string=""）不是 nil，但业务上可能需要忽略 —— 这个逻辑必须由 ORM 层控制，反射层只负责“读出来”
性能瓶颈在哪？什么时候该缓存反射结果
每次插入/查询都做完整反射（reflect.TypeOf + 遍历所有字段 + 提取 tag + 获取值）开销很大，实测比纯字符串拼接慢 5–10 倍。
- 缓存粒度建议到
reflect.Type级别：用sync.Map存map[reflect.Type]*structMeta -
structMeta至少包含：fieldNames []string（db 标签名）、getters []func(interface{}) interface{}（预编译的取值函数） - 不要缓存
reflect.Value，它绑定了具体实例，无法复用；缓存reflect.Type和字段索引即可 - 如果结构体极少变动（如服务启动后不再加载新 model），甚至可考虑在 build 时用
go:generate生成静态映射代码，彻底避开运行时反射
最易被忽略的一点：反射拿到的字段顺序和 struct 定义顺序一致，但数据库 INSERT 语句中字段顺序错位不会报错，只会静默写入错误列 —— 所以务必校验 tag 名与实际表结构的一致性，最好在启动时做一次 schema check。
