外键在被关联表则主表用HasOne、被关联表用BelongsTo，反之亦然；foreignKey和references须显式标注且类型一致；Preload发两条SQL，Joins生成单条LEFT JOIN；AutoMigrate需字段存在、类型匹配且标签完整才建外键约束。
外键在哪张表里，就决定了该用 HasOne 还是 BelongsTo ——选错会导致 Preload 查不到数据、Create 不写外键、AutoMigrate 无法建约束。
怎么判断该用 HasOne 还是 BelongsTo
只看外键字段物理上落在哪张表：
- 如果外键在「被关联表」（比如
CreditCard表里有UserID字段），那么主表User用HasOne，CreditCard用BelongsTo - 如果外键在「主表」（比如
User表里有CreditCardID字段），那就反过来：User用BelongsTo，CreditCard用HasOne - 别被业务语义带偏：“用户有一张卡”不等于必须用
HasOne；GORM 只认字段位置，不认中文描述
foreignKey 和 references 标签必须显式写全
GORM 默认按命名规则推断外键，但实际项目中几乎总会踩坑——字段名稍有偏差或主键非 ID 就会失效：
-
foreignKey写在拥有关系的结构体字段上，表示“本表用哪个字段存对方的 ID”，例如CreditCard CreditCard `gorm:"foreignKey:UserID"` -
references必须配套使用，指明“对方表用哪个字段被引用”，默认是ID，但如果对方主键叫Code或UUID，就得写references:Code - 字段类型必须严格一致：比如
User.ID是uint，那CreditCard.UserID也得是uint，不能是int或int64
Preload 和 Joins 的行为差异很关键
两者生成的 SQL 完全不同，影响性能和结果集结构：
-
db.Preload("CreditCard").Find(&users)：发两条 SQL，先查users，再根据所有user.ID批量查credit_cards；适合 N+1 场景，但无法做 WHERE 条件过滤关联表字段 -
db.Joins("JOIN credit_cards ON credit_cards.user_id = users.id").Find(&users)：单条 LEFT JOIN，能对credit_cards.number加 WHERE，但返回的是扁平结构，需手动映射嵌套字段 - 注意：
Preload不等于 JOIN，它底层是子查询 + IN，不是真正意义上的连接查询
AutoMigrate 不会自动加外键约束，除非字段和标签完全匹配
很多人以为写了 foreignKey 标签，AutoMigrate 就会建 FOREIGN KEY，其实不会：
- 必须确保外键字段存在且类型匹配（如
UserID uint对应User.ID uint） - 必须显式指定
foreignKey和references，缺一不可 - 如果外键字段名是
UserRefer而不是默认的UserID，又没写foreignKey:UserRefer，AutoMigrate就只会建普通索引，不建约束
最容易被忽略的一点：外键字段本身必须作为结构体字段显式定义，不能只靠 tag 隐式存在。比如 CreditCard 里没声明 UserID uint，哪怕 tag 写了 foreignKey:UserID，迁移也不会生效，预加载也会静默失败。
