ThinkPHP关联查询需显式定义方向与字段：belongsTo看外键所在表，hasOne看主键所在表；多对多用belongsToMany并传全参数；with预加载得嵌套对象，join得平铺字段，筛选用hasWhere或whereHas。
ThinkPHP模型定义关联查询，核心是通过在模型类中声明关联方法，明确表间关系方向和字段映射，而不是依赖自动猜测。写错方向或漏参数，常导致查不到数据且无报错，排查困难。
先分清 belongsTo 和 hasOne 谁属于谁
关键看外键在哪张表：
- User 表里有 category_id → User belongsTo Category（用户属于某个分类）
- Category 表里有 admin_id → Category hasOne User（分类拥有一个管理员）
只写其中一个方法，或者把两者写反，都会让 with('xxx') 返回空对象。必须成对定义、方向一致，才能双向访问。
外键和主键必须显式指定
ThinkPHP 不会智能推断非标准字段名：
-
belongsTo(Category::class)默认找本表的category_id去匹配 Category 的id；如果实际字段是cat_id，就得写belongsTo(Category::class, 'cat_id') -
hasOne(Profile::class)默认按 Profile 表的user_id关联；但多数场景是 Profile 表存uid，所以得写hasOne(Profile::class, 'uid') - 若主键不是
id（比如 User 表主键是uid），belongsTo 还要补第三个参数：belongsTo(User::class, 'owner_id', 'uid')
多对多要用 belongsToMany，别写 _belongsToMany
ThinkPHP 6+ 没有下划线前缀的方法名：
- 正确写法：
belongsToMany(Role::class, 'sys_user_role', 'uid', 'rid', 'id', 'id') - 参数依次为：关联模型、中间表名、当前模型在中间表的外键、关联模型在中间表的外键、当前模型主键、关联模型主键
- 中间表字段命名不标准（如用
uid/rid而非user_id/role_id），必须全量传参，不能省略
预加载 with 和手动 join 用途不同
别混用，选错会影响后续逻辑：
-
with('category')返回嵌套对象（$user->category->name），适合分页、简单展示，但不能对category.name直接where或order -
join()返回一维数组（字段平铺如user.name,category.name），能用where('category.status', 1)，但结果可能因笛卡尔积重复，且不触发模型事件 - 需要关联字段筛选时，优先用
hasWhere('category', ['status' => 1])或whereHas('category', fn($q) => $q->where('status', 1))
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
