belongsTo和hasOne需按外键位置区分：User表含category_id则User belongsTo Category；Category表含admin_id才用hasOne。必须显式指定foreignKey和localKey，with预加载须确保关联方法有return，join适合where/order关联字段，with适合分页和嵌套返回。
ThinkPHP 的模型关联查询不是“写对就行”，而是必须严格匹配外键逻辑和方法返回值，否则查不到数据却无报错——这是最常踩的坑。
belongsTo 和 hasOne 怎么分清谁 belongsTo 谁
核心就一条：看「外键在哪张表」。比如 User 表里有 category_id 字段，那 User 就 belongsTo Category；反过来，Category 表里没有用户 ID，它只「拥有一个」管理员（admin_id），才用 hasOne。
常见错误是把方向写反，结果 User::with('category')->find(1) 返回空对象，category 属性为 null，但控制台不报错，排查极难。
-
belongsTo必须显式指定foreignKey，例如$this->belongsTo(Category::class, 'category_id')；不写的话 ThinkPHP 默认猜category_id，一旦字段叫cat_id就失效 -
hasOne默认按当前模型主键（如id）去关联，如果对方表用的是sn字段，就得加localKey：$this->hasOne(Profile::class, 'user_id', 'sn')
with 预加载为什么还是发了多条 SQL
根本原因只有两个：关联方法没定义，或定义了但没 return。ThinkPHP 的 with 是靠反射调用模型里的方法，方法体里没 return $this->belongsTo(...)，就等于没声明关联。
立即学习“PHP免费学习笔记（深入）”；
- 检查模型中关联方法是否是
public function category()这种命名，且末尾有return - 嵌套预加载如
with(['category', 'profile.address'])，要求Profile模型也正确定义了address()方法，缺一不可 - 若只查部分字段，用闭包限制：
with(['category' => function ($q) { $q->field('id,name'); }])，避免拖回整张表
join 和 with 该选哪个
不是“高级用 with、简单用 join”，而是看后续怎么处理数据：
- 需要对关联字段做
where或order（比如where('category.name', 'like', '%tech%')），必须用join；with的闭包只能约束关联模型自身的条件 -
join返回一维数组，字段平铺（如user.name,category.name），适合直接渲染或导出 -
with返回嵌套对象（$user->category->name），适合分页、序列化、API 返回，但注意：关联对象默认只读，改了$user->category->name再save()不会写入数据库
关联数据更新失败的真正原因
很多人写了 $user = User::with('category')->find(1); $user->category->name = 'New'; $user->category->save();，发现数据库没变——这不是 bug，是设计行为。
with 加载的关联对象是独立快照，不绑定事务，也不走验证逻辑。要更新，要么重新实例化：Category::find($user->category_id)->save(['name' => 'New'])，要么用 load() 强制重载并绑定：$user->load('category') 后再操作（TP6.0+ 支持）。
最易被忽略的是：关联字段名和模型方法名不一致时，with 会静默失败；而 join 即使字段写错，也会报 SQL 错误——反而更容易定位问题。
