go反射只能访问首字母大写的导出字段，小写字段fieldbyname返回无效值；db tag解析需先判空再处理；嵌入字段须递归扁平化；time.time和指针类型需显式处理零值与nil。
reflect.Value.FieldByName("Name") 返回无效值？
因为 Go 反射只能访问导出字段（首字母大写），小写字段如 userName 即使打了 db:"user_name" tag，FieldByName("userName") 也会返回 IsValid() == false。这不是 bug，是语言设计强制的可见性规则。
实操建议：
- 所有需映射的字段必须首字母大写，例如
UserName string `db:"user_name"` - 别试图用反射“偷看”未导出字段——做不到，也别封装 hack 函数绕过
- 若必须兼容 legacy 小写字段结构体，得用
reflect.TypeOf(v).NumField()遍历全部字段，再逐个比对field.Tag.Get("db")是否匹配目标列名
db tag 解析时 panic 或提取失败？
StructTag.Get("db") 本身不会 panic，它在 tag 不存在或格式错误时只返回空字符串。真正容易 panic 的是后续操作，比如直接对空字符串调用 strings.Split(tag, ",")[0]。
实操建议：
- 永远先判空：
tag := field.Tag.Get("db"); if tag == "" { continue } - 用
strings.TrimSpace(tag)清理前后空格，避免因空格导致== ""判定失效 - 优先采用逗号分隔语义，如
db:"created_at,notnull,default:now()"，比空格分隔更健壮、易解析 - 不要硬拆空格——用户可能在 tag 里写
db:"user name"，空格不是结构化分隔符
拼 INSERT 语句时字段名/值顺序错乱？
反射遍历字段顺序就是 struct 定义顺序，但若结构体含匿名嵌入字段（Extra Info `db:",inline"`），且没做递归扁平化处理，会导致字段漏掉或顺序错位，最终 columns 和 values 切片长度不一致。
实操建议：
- 遇到
field.Anonymous && field.Tag.Get("db") == ",inline"，必须递归进入其类型，并用当前字段名作前缀拼接列名（如"extra_created_at"） - 字段名列表和参数值列表必须严格按同一遍历路径生成，推荐提前构建两个切片：
cols = append(cols, colName)、args = append(args, val)，最后统一strings.Join() - 别在循环里反复
fmt.Sprintf拼 SQL——性能差，还容易漏转义
time.Time 或 *string 字段写入数据库报 driver 错误？
反射拿到的是 reflect.Value，直接调 v.Interface() 返回原始 Go 值，但数据库驱动对零值、nil 指针、未实现 driver.Valuer 的自定义类型很敏感，常见错误如 driver: couldn't parse time.Time 或 converting argument $1 type: unsupported type **string。
实操建议：
- 对
time.Time：先检查t.IsZero()，业务决定填NULL还是默认时间 - 对指针类型（如
*string）：用field.CanInterface() && field.IsNil()判空，传nil给参数切片 - 对 JSON 类型字段（tag 含
json:"metadata"），检测 Go 类型是否为struct/map/slice，再手动json.Marshal成[]byte或string - 最稳妥方式：把处理后的值统一塞进
args切片，交给database/sql自己调Value()方法，别自己拼字符串
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
