不能直接映射到任意结构体，必须满足字段导出、命名匹配或显式db/column标签绑定；GORM默认按结构体字段名（非数据库列名）映射，不匹配则静默置零。
查询结果能直接映射到任意结构体吗
可以，但必须满足字段名匹配或显式绑定规则。GORM 默认按字段名（非数据库列名）做映射，且要求目标结构体字段是导出的（首字母大写）。如果结构体字段名和数据库列名不一致，又没加标签，GORM 会跳过该字段，不会报错，但值为空——这是最常见的静默失败原因。
- 结构体字段必须是导出字段（如
Name，不能是name） - 默认按字段名映射，不是按列名；
gorm:"column:user_name"这类标签只影响写入或建表，对Find/First查询时的映射无直接影响 - 若用
Select("user_name as name")，则需结构体字段名为Name，且 GORM 能识别别名（v1.23+ 支持较好，旧版可能失效） - 嵌套结构体、匿名字段、指针字段均可映射，但需注意零值覆盖逻辑
用 Raw SQL 查询时怎么安全映射到自定义结构体
Raw SQL 是最灵活也最容易出错的方式。GORM 的 Raw().Scan() 不走 ORM 字段映射逻辑，而是严格按 SELECT 列顺序与结构体字段声明顺序一一对应。一旦顺序错、类型不匹配或字段数不等，就会 panic 或静默丢数据。
- 务必保证
SELECT字段顺序和结构体字段声明顺序完全一致 - 字段类型必须兼容：例如数据库
INT对应 Go 的int、int64或*int64；NULL列建议用指针类型接收（如*string） - 避免用
*，显式写出所有要映射的列，防止表结构变更后字段错位 - 示例：
type UserSummary struct { ID uint `gorm:"column:id"` Name string `gorm:"column:name"` Email *string } db.Raw("SELECT id, name, email FROM users WHERE id = ?", 1).Scan(&UserSummary{})
想复用已有模型但只查部分字段，该用 Find 还是 Select
用 Select() 配合模型结构体更稳妥。GORM 的 Find() 总是尝试填充整个结构体，未 SELECT 的字段会被置为零值（比如 int 变 0，string 变 ""），容易掩盖真实数据状态；而 Select() 明确指定字段后，GORM 仅设置这些字段，其余保持原值（适用于局部更新场景）或初始化为零（用于新结构体）。
- 如果目标是「构造一个轻量结构体」，推荐新建专用结构体 +
Select()，而非复用全量模型 -
db.Select("name, email").Find(&u)中u必须是完整模型类型（如User），未选字段被清零 - 若用新结构体（如
type NameEmail struct { Name string; Email string }），必须配合Raw()或Scan()，Find()不支持自动适配非模型结构体 - v2 版本中
db.Table("users").Select("name, email").Scan(&dst)是更清晰的选择，绕过模型约束
聚合查询或 JOIN 结果怎么映射到结构体
JOIN 和聚合（如 COUNT()、MAX()）必然导致列名脱离原始模型，此时不能再依赖 Find()，必须用 Scan() + 显式结构体。GORM 不解析 SQL 别名是否对应字段，只认结构体字段顺序和类型。
立即学习“go语言免费学习笔记（深入）”；
- 给每列加明确别名，并让结构体字段名与之完全一致（大小写敏感）
- 聚合函数返回类型需匹配：例如
COUNT(*)是int64，结构体字段得是Count int64，不能是int（32 位系统可能溢出） - JOIN 多表时，避免列名冲突：用
users.name AS user_name和posts.title AS post_title，结构体字段就叫User_Name和Post_Title（或按规范用UserNname） - 不要指望
Joins("LEFT JOIN posts...").Select("users.name, COUNT(posts.id)")能直接Find(&dst)—— 它会失败或映射错乱
最易被忽略的一点：GORM v2 默认开启 PrepareStmt，而某些 Raw SQL 绑定在预编译模式下对结构体字段顺序更敏感；如果 Scan 出现莫名字段错位，先试 db.Session(&gorm.Session{PrepareStmt: false}) 排查。
