sqlx 是 database/sql 的增强层而非 orm，通过反射自动绑定列名、支持命名参数和嵌套扫描提升开发效率；需用 sqlx.get/select 替代原生 scan，正确使用 sqlx.in/rebind 处理 in 查询，事务中必须使用 sqlx.tx，连接池与上下文超时需手动配置。
Sqlx 在 Golang 微服务中不是“ORM”，也不是“全栈方案”，它只是 database/sql 的增强层——用对了省心，用错了反而多一层隐式耦合。
为什么不用原生 database/sql 直接写查询
原生 database/sql 要手动 Scan 字段、处理 sql.Null*、拼接 SQL 时易出错，且结构体字段和列名映射靠位置而非名称，一旦 DB 字段顺序调整或加了 SELECT * 就可能 panic。
Sqlx 通过反射自动绑定列名到结构体字段（默认按名称匹配），支持命名参数（:name）、嵌套结构体扫描、批量操作等，微服务里查配置、日志、状态表这类简单但高频的场景，写法更直觉。
常见错误现象：sql: Scan error on column index 0: unsupported driver -> Scan pair: *string -> *interface{}——这是没用 sqlx.Get/sqlx.Select，而直接拿 *sql.Rows 去 Scan 结构体导致的。
- 必须用
sqlx.DB或sqlx.Tx替代原生*sql.DB - 查询单行用
Get，多行用Select，不推荐QueryRow+Scan组合 - 字段名不匹配时，默认大小写敏感；可统一用
db.MapperFunc(strings.ToLower)适配 PostgreSQL 小写下划线风格
sqlx.In 和 sqlx.Rebind 处理 IN 查询的正确姿势
微服务常要查一组 ID 对应的资源（如订单查多个用户信息），但原生 SQL 不支持参数化 IN (?)，硬拼字符串有注入风险。Sqlx 提供 sqlx.In 拆包 + sqlx.Rebind 重写占位符，是标准解法。
典型错误：直接把 slice 传给 db.Query，报错 sql: converting argument type: unsupported type []int64, a slice of int64。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 先调
sqlx.In("SELECT * FROM users WHERE id IN (?)", ids)得到带?占位符的 SQL 和新参数列表 - 再用
db.Rebind把?转成目标驱动格式（如 PostgreSQL 用$1, $2，MySQL 用?, ?） - 最终用
db.Select或db.Get执行，别漏掉...args展开
示例：
query, args, _ := sqlx.In("SELECT * FROM orders WHERE user_id IN (?)", userIds)
query = db.Rebind(query)
var orders []Order
err := db.Select(&orders, query, args...)
事务中嵌套使用 sqlx.Tx 而非复用全局 sqlx.DB
微服务里一个 HTTP 请求常涉及多个 DB 操作（如扣库存 + 写订单 + 发通知记录），必须包裹在事务里。Sqlx 的 sqlx.Tx 是 *sql.Tx 的包装，所有 Get/Select/Exec 方法都可用，但不能和全局 sqlx.DB 混用。
容易踩的坑：db.MustExec 写在事务函数里却用了全局 db，导致操作脱离事务，数据不一致。
- 事务开始后，所有 DB 操作必须走
tx := db.MustBegin()返回的*sqlx.Tx - 不要在事务函数里调用其他依赖全局
sqlx.DB的工具函数，要么传入*sqlx.Tx，要么重构为接受sqlx.Ext接口（sqlx.Tx和sqlx.DB都实现了它） - 注意
tx.Commit()后tx不可再用，但tx本身不会自动 close，也不需要手动 close
连接池与上下文超时需独立配置，Sqlx 不接管这些
Sqlx 自身不管理连接池、不处理 context 超时——它只负责 SQL 构建和结果扫描。微服务对 DB 的稳定性要求高，连接池参数（SetMaxOpenConns、SetMaxIdleConns）和查询上下文（context.WithTimeout）必须由上层控制。
典型疏忽：只设了 http.Server.ReadTimeout，但 DB 查询卡住时，连接池被占满，整个服务夯住。
- 初始化
sqlx.DB后立刻配置连接池：db.SetMaxOpenConns(20)、db.SetMaxIdleConns(10) - 所有查询必须带 context：
db.GetContext(ctx, &u, "SELECT ...", id)，并在 handler 层传入带 timeout 的 context - PostgreSQL 用户注意：
pgx驱动比lib/pq更高效，但 Sqlx 兼容两者；若换驱动，只需改 import 和sqlx.Connect的 driverName，其余代码不变
最常被忽略的一点：Sqlx 的 NamedQuery 和 BindStruct 看似方便，但在高频写入路径里反射开销明显，简单 INSERT/UPDATE 建议手写 SQL + Exec，别为了“少写两行”牺牲可观测性和性能。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
