ThinkPHP6模型关联查询通过定义hasOne、hasMany、belongsTo、belongsToMany等关系方法并配合with()预加载或load()动态加载实现，支持嵌套关联与闭包条件筛选，有效避免N+1问题。
ThinkPHP6 的模型关联查询主要通过定义关联关系（如 hasOne、hasMany、belongsTo、belongsToMany 等） + with() 或 load() 方法实现，写法清晰且支持链式操作和条件控制。
一、定义关联方法（在模型中）
在对应模型类里，用公共方法返回关联对象。注意命名规范和参数准确：
-
一对一（主表查从表）：比如用户（
User）和头像（Avatar），一个用户一个头像
public function avatar()
{
return $this->hasOne(Avatar::class, 'user_id', 'id');
}
-
一对多（主表查多个从表）：比如文章（
Article）和评论（Comment）
public function comments()
{
return $this->hasMany(Comment::class, 'article_id', 'id');
}
- 反向关联（从表查主表）：比如评论查所属文章
public function article()
{
return $this->belongsTo(Article::class, 'article_id', 'id');
}
-
多对多（中间表）：比如用户（
User）和角色（Role），中间表user_role
public function roles()
{
return $this->belongsToMany(Role::class, 'user_role', 'role_id', 'user_id');
}
二、使用 with() 预加载（推荐，避免 N+1 查询）
在查询主模型时，一次性把关联数据查出来，性能更好：
- 查用户 + 头像：
User::with('avatar')->find(1) - 查文章 + 所有评论：
Article::with('comments')->find(5) - 查用户 + 角色（多对多）：
User::with('roles')->find(1) - 嵌套关联（用户 + 头像 + 头像所属分类）：
User::with(['avatar.category'])->find(1)
三、带条件的关联查询
可在 with() 中传匿名函数，对关联模型加 where、limit、order 等：
立即学习“PHP免费学习笔记（深入）”；
- 只查已审核的评论：
Article::with(['comments' => function ($query) { $query->where('status', 1); }])->find(5) - 查最新一条评论：
Article::with(['comments' => function ($query) { $query->order('id', 'desc')->limit(1); }])->find(5)
四、动态获取关联数据（非预加载）
适合单个模型实例后按需加载，用 load()：
$user = User::find(1); $user->load('avatar');$user->load(['avatar', 'roles']);- 同样支持闭包条件：
$user->load(['comments' => function($q){ $q->where('is_top', 1); }]);
关联字段默认会自动注入到结果数组中，例如 $user->avatar 就是 Avatar 模型实例（或 null），可直接调用属性或方法。注意确保外键字段名、主键名、模型类路径正确，否则会查不到数据。
