泛型函数通过接收 T any 类型参数并运行时校验为结构体指针来实现数据库映射，必须用 reflect.ValueOf(entity).Elem() 获取可反射的结构体值，结合 StructTag.Get("db") 提取列名，且需显式处理嵌套、空标签和大小写转换；SQL 构建应解耦为方言接口而非泛型逻辑。
泛型函数如何接收任意结构体并映射到数据库表
Go 的泛型不能直接反射结构体标签，所以 interface{} + 类型约束是唯一可行路径。关键在于用 any（即 interface{}）接收参数，再通过类型约束限定为结构体指针：type Entity interface{ ~struct{} } 不行，必须用 type Entity interface{ any } 并在函数内做运行时校验。
常见错误是试图用 func Save[T struct{}](t T) —— Go 不允许 struct{} 作为类型约束，会报 syntax error: unexpected struct。正确写法是：
func Save[T any](db *sql.DB, entity T) error {
v := reflect.ValueOf(entity)
if v.Kind() == reflect.Ptr {
v = v.Elem()
}
if v.Kind() != reflect.Struct {
return fmt.Errorf("entity must be a struct or pointer to struct")
}
// 后续字段遍历、tag 解析、SQL 拼接...
}
注意：必须接受指针（如 *User），否则无法读取 json、db 等 struct tag；若传值类型（User），reflect.ValueOf 无法获取 tag 信息。
如何从 struct tag 提取列名而不依赖第三方反射库
Go 原生 reflect.StructTag 支持标准 db tag，但要注意两点：一是 tag 值必须用双引号包裹（`db:"id"`），单引号或无引号会导致 tag.Get("db") 返回空；二是空格和逗号分隔的选项（如 db:"name,omitempty"）需手动解析，标准库不提供 omitempty 自动跳过逻辑。
立即学习“go语言免费学习笔记（深入）”；
实操建议：
在 Golang 中使用 samber/hot 进行内存缓存，支持 LRU、LFU、TinyLFU、W‑TinyLFU、S3FIFO、ARC、TwoQueue、SIEVE、FIFO 等淘汰算法，提供 TTL、缓存加载器及分片功能。
- 统一约定使用
dbtag，避免混用json或自定义 tag，减少歧义 - 字段名默认取 struct 字段名（
FieldName），仅当dbtag 非空且非"-"时覆盖 - 遇到
db:"-"（含尾部空格）要 trim，否则误判为有效列名 - 嵌套结构体不自动展开——ORM 中不支持
Address struct{ City string `db:"city"` }直接平铺，必须显式展平或拒绝处理
INSERT 和 SELECT 的泛型参数设计差异在哪
Insert 和 Select 的泛型约束表面相似，实际行为完全不同：前者输入是待写入的实体（T），后者输出是查询结果容器（[]T 或 *T），但数据库驱动返回的是 []map[string]any 或 rows.Scan 接口，无法直接转成 T。
所以 Select 必须拆成两步：
- 先用
reflect.New(reflect.TypeOf(new(T)).Elem()).Interface()创建零值实例，用于rows.Scan绑定 - 再用反射逐字段赋值，不能依赖
json.Unmarshal（因为 column 名和字段名可能不一致） -
Insert可直接用reflect.ValueOf(entity).Elem()遍历字段；Select必须额外传入sql.Rows或封装好的扫描器，否则泛型无法推导扫描目标 - 切片结果类型必须是
[]*T而非[]T，否则Scan无法写入——这是最常被忽略的内存模型陷阱
为什么不能把 SQL 拼接逻辑也泛型化
泛型函数能复用字段遍历、tag 解析、参数绑定，但 SQL 字符串拼接本身不该泛型化。原因很实在：不同方言（PostgreSQL vs MySQL）对占位符、关键字、类型转换语法要求不同，硬塞进一个泛型函数里只会导致分支爆炸或隐式错误。
正确做法是把 SQL 构建抽成接口：
type Dialect interface {
InsertSQL(tableName string, fields []string) string
Placeholder(n int) string // "$1" vs "?"
}
然后按需注入：Save[T](db *sql.DB, ent T, dialect Dialect)。否则你会遇到：
- MySQL 允许
INSERT INTO t VALUES (?, ?)，PostgreSQL 要求INSERT INTO t VALUES ($1, $2) - SQLite 的
last_insert_rowid()和 PostgreSQL 的RETURNING id完全无法统一 - 泛型函数内部写
if strings.Contains(db.DriverName(), "postgres")—— 违反单一职责，且测试难覆盖
泛型解决的是“结构体到数据的映射”，不是“SQL 到数据库的适配”。混淆这两层，后续加新数据库支持时就会卡死。
