GORM 不自动展开复杂结构体字段，必须显式使用 gorm:"embedded" 才能将嵌套结构体字段映射为数据库列；匿名字段默认被视为关联而非嵌入，忽略 embedded 会导致字段不映射且无报错。
直接说结论：GORM 对复杂结构体字段的映射不是“自动展开”，必须显式声明嵌套字段是否参与映射，否则字段会被忽略或报错；匿名字段不等于数据库列，gorm:"embedded" 才是开关。
struct tag 中不写 gorm:"embedded"，嵌套结构体不会映射到表字段
常见错误是把一个配置结构体直接嵌入主结构体，以为字段会自动扁平化到数据库表里：
type User struct {
ID uint
Profile UserProfile // 匿名字段，但没加 embedded
}
type UserProfile struct {
Nickname string
Avatar string
}
结果：GORM 完全忽略 Profile，既不建列，也不报错，查出来 Profile 字段永远是零值。原因：GORM 默认把非基本类型字段当关联（BelongsTo），而不是嵌入字段。
正确做法是显式加 gorm:"embedded"：
-
Profile UserProfile `gorm:"embedded"`→ 字段展开为nickname、avatar（蛇形命名） -
Profile UserProfile `gorm:"embedded;columnPrefix:profile_"`→ 展开为profile_nickname、profile_avatar - 如果嵌套结构体本身也有
gorm:"embedded"字段，会递归展开，但注意别循环引用
gorm:"column:xxx" 和 gorm:"embedded" 不能共存于同一字段
下面写法会静默失效（GORM 不报错，但嵌入逻辑被跳过）：
Profile UserProfile `gorm:"embedded;column:profile_data"`
因为 column: 指定的是单个列名，而 embedded 表示要展开成多个列——二者语义冲突。GORM 遇到这种组合，优先按 column: 处理，embedded 被丢弃。
如果你真需要把整个嵌套结构体序列化进一个 JSON 列（比如存用户偏好），那就别用 embedded，改用：
-
ProfileJSON []byte `gorm:"column:profile_data;type:json"`（PostgreSQL/MySQL 5.7+） - 或自定义
Scanner/Valuer接口做透明编解码 - 切记：此时
Profile字段需设为gorm:"-"避免重复映射
时间字段 + autoCreateTime 等 tag 在嵌入结构体中仍有效，但需注意接收者
嵌入结构体里的 time.Time 字段如果带 autoCreateTime，GORM 依然能识别并自动赋值，但有前提：
- 该字段必须是导出字段（首字母大写）
- 不能和外层结构体同名字段冲突（比如外层也有
CreatedAt） -
autoCreateTime只在Create()时生效，Save()不覆盖已有值 - 若嵌入结构体字段名是
CreatedAt，GORM 默认不会把它当全局时间戳字段，除非你额外加gorm:"autoCreateTime"
例如：
type Timestamps struct {
CreatedAt time.Time `gorm:"autoCreateTime"`
UpdatedAt time.Time `gorm:"autoUpdateTime"`
}
type User struct {
ID uint
Name string
Timestamps `gorm:"embedded"`
}
这样 CreatedAT 和 UpdatedAt 就会作为独立列存在，并在对应操作时自动填充。
关联字段和嵌入字段混用时，Preload 不会加载 embedded 字段
这是最容易被忽略的一点：embedded 是结构体层面的字段展开，和 GORM 的关联（HasMany、BelongsTo）完全无关。所以：
-
db.Preload("Profile").Find(&users)—— 如果Profile是嵌入字段，这行代码无效，Preload无意义 -
db.Preload("Orders").Find(&users)—— 如果Orders是HasMany关联，这才触发 JOIN 或额外查询 - 嵌入字段的值始终随主表查询一次性取出，没有懒加载或急加载概念
换句话说：embedded 是“编译期展开”，关联是“运行时关系”，两者不在一个抽象层级上。混用时务必分清哪些字段是扁平列、哪些是外键关联，别指望 Preload 去“预加载”嵌入字段。
