sqlx比database/sql更优，因其在完全兼容标准库前提下提供结构体自动扫描、命名参数支持及批量操作封装，省去手动Scan，迁移成本极低；初始化必须用sqlx.Open、调db.Ping()验证、显式设连接池参数。
为什么直接用 sqlx 而不是 database/sql？
因为 sqlx 在保持 database/sql 兼容性的同时，提供了结构体自动扫描、命名参数支持、批量操作封装等实用能力。如果你写的是原生 SQL（比如带 JOIN、复杂 WHERE 或自定义聚合），又不想手动逐字段 Scan，sqlx 是更省力的选择。
它不改底层驱动，所有连接池、事务、上下文行为和 database/sql 一致，迁移成本极低。
初始化 sqlx.DB 时必须注意的三件事
常见错误是直接用 sqlx.Connect 或漏掉 SetMaxOpenConns，导致线上连接耗尽或超时失败。
- 用
sqlx.Open（不是sqlx.Connect）——后者已废弃，且不返回 error - 务必调用
db.Ping()验证连接有效性，否则首次查询才暴露问题 - 显式设置连接池参数：
db.SetMaxOpenConns(20)、db.SetMaxIdleConns(10)，尤其在容器环境下默认值（0/2）极易引发雪崩
示例：
立即学习“go语言免费学习笔记（深入）”；
db, err := sqlx.Open("postgres", "user=xxx dbname=xxx sslmode=disable")
if err != nil {
log.Fatal(err)
}
if err = db.Ping(); err != nil {
log.Fatal(err)
}
db.SetMaxOpenConns(20)
db.SetMaxIdleConns(10)
QueryRowx 和 Get 的区别在哪？什么时候该用哪个？
两者都用于单行查询，但语义和错误处理逻辑不同，混用容易漏错。
-
Get：要求「必须有且仅有一行」，没有数据时返回sql.ErrNoRows，多行时直接 panic —— 适合主键查询、唯一约束场景 -
QueryRowx：行为同database/sql的QueryRow，只校验「最多一行」，没数据时Scan返回sql.ErrNoRows，多行会被静默截断 —— 更灵活，但需自己判空
推荐优先用 Get，除非你明确需要容忍空结果且不关心多行风险。例如：
var user User err := db.Get(&user, "SELECT * FROM users WHERE id = $1", 123) // 没有则 err == sql.ErrNoRows
使用命名参数时，NamedQuery 的坑比你想象中多
很多人以为写 SELECT * FROM users WHERE name = :name 就能直接跑，但实际会报 sql: expected 1 arguments, got 0。
- 必须用
NamedQuery（或NamedExec）才能解析:name这类命名参数，普通Query只认$1位置参数 - 传参必须是 map 或 struct；map 键名要和 SQL 中冒号后的名字完全匹配（区分大小写）
- struct 字段需有对应 tag，如
type User { Name string `db:"name"` }，否则字段名转小写后匹配，易出错
正确写法：
rows, err := db.NamedQuery("SELECT * FROM users WHERE role = :role AND active = :active",
map[string]interface{}{"role": "admin", "active": true})复杂查询里字段别名、嵌套结构、NULL 处理这些细节，往往比连接配置更容易翻车。动手前先用 db.Rebind 看一眼生成的问号语句，比靠猜靠谱得多。
