Go Academy · 课时

sqlx：结构体扫描与命名查询

使用 sqlx 的 Get、Select 与 NamedExec

sqlx：结构体扫描与命名查询 是 CoddyKit 上的免费 Go Academy 课时。这是第 2 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Go Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Go Academy 课程共包含 4 节课。

什么是 sqlx？

github.com/jmoiron/sqlx 在 database/sql 的基础上扩展了结构体扫描、命名查询和查询内绑定功能。它与 database/sql 的 API 兼容。

sqlx.Open

使用 sqlx 而不是 sql 打开数据库连接：

db, err := sqlx.Open("postgres", dsn)
if err != nil { log.Fatal(err) }

Get 和 Select

db.Get 会将单行扫描到结构体中；db.Select 会将多行扫描到切片中：

var user User
db.GetContext(ctx, &user, "SELECT * FROM users WHERE id=$1", id)

var users []User
db.SelectContext(ctx, &users, "SELECT * FROM users WHERE active=$1", true)

结构体标签

sqlx 使用 db 标签将列映射到结构体字段：

type User struct {
    ID    int    `db:"id"`
    Name  string `db:"name"`
    Email string `db:"email"`
}

命名查询

使用 :name 语法指定命名参数，并传入结构体或映射：

query := "INSERT INTO users (name, email) VALUES (:name, :email)"
_, err := db.NamedExecContext(ctx, query, user)

sqlx.In

sqlx.In 会将切片展开为 SQL IN 子句：

ids := []int{1, 2, 3}
query, args, _ := sqlx.In("SELECT * FROM users WHERE id IN (?)", ids)
query = db.Rebind(query)
db.SelectContext(ctx, &users, query, args...)

Rebind

db.Rebind(query) 会将占位符 ?（由 sqlx.In 使用）转换为驱动特定的格式（PostgreSQL 使用 $1、$2）：

StructScan

使用 rows.StructScan 将单行扫描到结构体中：

rows, _ := db.QueryxContext(ctx, "SELECT * FROM users")
for rows.Next() {
    var u User
    rows.StructScan(&u)
}

MustExec

db.MustExec 会执行查询，并在发生错误时引发 panic——适用于架构迁移或测试设置，因为这些场景中的错误始终意味着无法继续。

db.MustExec(schema)

Unsafe

db.Unsafe() 会返回一个在遇到未映射列时静默忽略它们的版本，而不是返回错误——当 SELECT 返回的列多于结构体字段时很有用。

sqlx 与 ORM

sqlx 通过 Go 原生结构体绑定让您完全控制 SQL。GORM 等 ORM 会隐藏 SQL，但可能生成意料之外的查询。如果您希望使用明确的 SQL，同时获得便捷的扫描功能，请使用 sqlx。

快速检查

db.SelectContext 在 sqlx 中的作用是什么？

回顾：sqlx

要点：

Get/Select 使用 db 标签将结果直接扫描到结构体中
使用 :name 语法和 NamedExecContext 执行命名查询
使用 sqlx.In + Rebind 处理带切片的 IN 子句
使用 StructScan 在循环中逐行扫描到结构体

常见问题解答

「sqlx：结构体扫描与命名查询」课时是免费的吗？

是的 — 「sqlx：结构体扫描与命名查询」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Go Academy 课程的其余内容，请升级到 CoddyKit PRO。 Go Academy 课程共包含 4 节课。

「sqlx：结构体扫描与命名查询」这节课中我会学到什么？

使用 sqlx 的 Get、Select 与 NamedExec 你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Go Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Go Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 2 节课，共 4 节。

「sqlx：结构体扫描与命名查询」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Go Academy 课中编写并运行代码吗？

能。每节 Go Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Go Academy