Go 语言无官方 ORM，sqlx 是最轻量稳定的“简单 ORM”方案，通过 db tag 实现结构体自动映射，需注意字段名匹配、ErrNoRows 处理、事务显式传递及复杂查询宜手写 SQL。
Go 语言没有官方 ORM，database/sql 本身只是抽象层，所谓“简单 ORM”本质是封装查询构造、结构体映射和事务控制——不是追求功能完整，而是避免重复写 rows.Scan() 和手拼 SQL。
用 sqlx 实现结构体自动映射
sqlx 是最轻量且稳定的替代方案，它复用 database/sql 接口，只增强扫描逻辑。它能直接把查询结果塞进 struct 字段，前提是字段名匹配（支持 db tag）。
常见错误：字段没加 db tag 或大小写不一致导致零值；用 Get 查询单行时没处理 sql.ErrNoRows。
- 安装：
go get github.com/jmoiron/sqlx - 定义 struct 时显式标注：
type User struct { ID int `db:"id"` Name string `db:"name"` } - 查询单行：
err := db.Get(&u, "SELECT id, name FROM users WHERE id = ?", 123)，失败时err == sql.ErrNoRows是合法分支，不是异常 - 批量查多行：
err := db.Select(&users, "SELECT * FROM users WHERE status = ?", "active")，users必须是切片指针
手写 Insert 和 Update 的参数安全写法
别拼接 SQL 字符串，也别依赖第三方 query builder。用 struct 字段反射生成列名和占位符，再交由 db.Exec 绑定参数——既安全又可控。
立即学习“go语言免费学习笔记（深入）”；
关键点：反射获取字段名时跳过空字段或主键；UPDATE 语句必须明确指定 WHERE 条件，否则全表覆写。
- 插入示例：
INSERT INTO users (name, email) VALUES (?, ?)，参数从 struct 取值顺序必须与列顺序严格一致 - 更新示例：
UPDATE users SET name = ?, email = ? WHERE id = ?，最后一个参数永远是主键或业务唯一键 - 避免用
map[string]interface{}做参数，类型丢失会导致driver.Value转换失败
事务中嵌套操作必须共用同一个 *sql.Tx
很多人误以为用 db.Begin() 后，所有后续 db.Query 会自动走事务——不会。db 是连接池，事务必须显式传入 *sql.Tx 实例。
典型翻车现场：在事务里调用了一个封装好的 FindUserByID 函数，但它内部仍用 db.Get，导致查的是事务外的快照数据。
- 正确做法：所有事务内操作函数签名带
tx *sql.Tx参数，例如func CreateUser(tx *sql.Tx, u *User) error - 事务结束前不能调用任何以
*sql.DB为 receiver 的方法 -
tx.Commit()和tx.Rollback()都会关闭事务，之后再用该tx会 panic："sql: transaction has already been committed or rolled back"
真正难的不是怎么映射字段，而是什么时候不该用 ORM 封装——比如复杂 JOIN、窗口函数、bulk insert 场景，硬套结构体映射反而增加心智负担。保持 sqlx + 手写 SQL 的组合，比引入全功能 ORM 更贴近 Go 的务实风格。
