查询行
读取结果集
查询行 是 CoddyKit 上的免费 Go Academy 课时。 这是第 2 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Go Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Go Academy 课程共包含 4 节课。
查询结果集
对于返回行的语句（例如 SELECT），请使用 Query。它会返回一个可迭代的 *sql.Rows。如果只需要一个值，QueryRow 会更加简单。
db.Query
Query 会发送 SQL 并返回行以及一个错误。在使用这些行之前，请始终先检查错误。
rows, err := db.Query("SELECT id, name FROM users WHERE active = $1", true)
if err != nil {
log.Fatal(err)
}始终 defer rows.Close()
这些行会一直持有数据库连接，直到被关闭。defer rows.Close() 会将连接归还到连接池。忘记执行这一步会在高负载下造成连接泄漏。
defer rows.Close()使用 rows.Next 进行迭代
rows.Next() 会前进到下一行，并在没有更多行时返回 false。在循环内部，请调用 Scan 将列值复制到变量中。
for rows.Next() {
var id int
var name string
if err := rows.Scan(&id, &name); err != nil {
log.Fatal(err)
}
fmt.Println(id, name)
}Scan 接受指针
Scan 会写入您传入的变量，因此必须传入指针（&id、&name）。指针的数量和顺序必须与选定的列相匹配。
检查 rows.Err
循环可能因为数据读取完毕而结束，也可能因为迭代过程中发生错误而结束。循环结束后，请调用 rows.Err() 来捕获迭代错误。
if err := rows.Err(); err != nil {
log.Fatal(err)
}使用 QueryRow 获取一行
当您预期恰好返回一行时，使用 QueryRow 配合 Scan 会更加简洁。如果没有匹配的行，Scan 会返回 sql.ErrNoRows。
var name string
err := db.QueryRow("SELECT name FROM users WHERE id = $1", 7).Scan(&name)
if err == sql.ErrNoRows {
fmt.Println("not found")
}可运行的 Scan 模拟示例
真实查询需要数据库，因此这个可运行示例使用内存切片模拟 Query、Next、Scan 流程，以展示迭代模式。
package main
import "fmt"
type Row struct {
ID int
Name string
}
func main() {
rows := []Row{{1, "Ada"}, {2, "Lin"}, {3, "Guido"}}
for i := 0; i < len(rows); i++ {
var id int
var name string
id = rows[i].ID
name = rows[i].Name
fmt.Printf("id=%d name=%s\n", id, name)
}
fmt.Println("scanned", len(rows), "rows")
}处理 NULL
NULL 列无法扫描到普通字符串或整数中。请使用 sql.NullString、sql.NullInt64 或指针类型，这样代码就能区分 NULL 和空值。
var email sql.NullString
rows.Scan(&email)
if email.Valid {
fmt.Println(email.String)
}将数据扫描到结构体
标准库会扫描到单独的变量中，而不是整个结构体。您可以通过传入 &u.ID, &u.Name 将列映射到结构体字段。sqlx 等库可以自动完成这项工作。
避免使用 SELECT *
请明确列出各个列，以确保 Scan 的顺序稳定。如果依赖 SELECT *，那么添加列的架构变更会悄无声息地破坏按位置进行的 Scan。
快速检查
请测试您对查询的了解。
总结
您学会了查询行：
- Query 返回 *sql.Rows；使用 defer rows.Close()
- 使用 rows.Next 循环，并通过 Scan 将数据复制到指针中
- 循环结束后检查 rows.Err()
- 使用 QueryRow 查询单行；未找到时返回 sql.ErrNoRows
- 对可为空的列使用 Null 类型
常见问题解答
「查询行」课时是免费的吗？
是的 — 「查询行」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Go Academy 课程的其余内容，请升级到 CoddyKit PRO。 Go Academy 课程共包含 4 节课。
「查询行」这节课中我会学到什么？
读取结果集 你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Go Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Go Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 2 节课，共 4 节。
「查询行」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Go Academy 课中编写并运行代码吗？
能。每节 Go Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。