ThinkPHP 6.x 中应使用 belongsToMany（无下划线），需显式配置中间表名、外键及主键，否则关联查询为空或报错；预加载须用 with('roles') 在 select 前调用，中间表字段筛选需用 whereHas 或 hasWhere。
ThinkPHP模型里_belongsToMany怎么写才不报错
直接说结论：ThinkPHP 6.x 中没有 _belongsToMany 这个方法名，这是常见误解——实际用的是 belongsToMany（无下划线），且必须配合中间模型或显式配置中间表字段，否则关联查询会返回空或抛出 Undefined index: pivot 类错误。
典型错误现象是：调用 $user->roles 返回空集合，但数据库里明明有记录；或者报错 Call to undefined method belongsToMany()，多因在模型里写了 _belongsToMany 却没定义对应方法。
- ThinkPHP 6+ 的关联方法全部是「驼峰命名」，如
hasMany、belongsTo、belongsToMany，绝无下划线前缀 - 必须在模型中用
protected $with = ['roles']或显式调用with('roles')才会加载关联，懒加载默认不触发 - 若中间表不是标准命名（如
role_user），必须手动指定表名、外键、主键，否则框架按约定猜错就查不到数据
中间表字段命名和配置必须对齐
ThinkPHP 默认按「字母顺序拼接 + _id」推导中间表字段，比如 User 和 Role 模型，默认找 role_user 表里的 user_id 和 role_id。一旦你的中间表叫 sys_user_role，或字段是 uid/rid，就必须全量声明。
实操建议直接写死参数，别依赖约定：
立即学习“PHP免费学习笔记（深入）”；
public function roles()
{
return $this->belongsToMany(Role::class, 'sys_user_role', 'uid', 'rid', 'id', 'id');
}
- 第2个参数：
'sys_user_role'是中间表名（不含前缀） - 第3个参数：
'uid'是当前模型（User）在中间表的外键字段 - 第4个参数：
'rid'是关联模型（Role）在中间表的外键字段 - 第5/6个参数：分别是两个模型自身的主键名（默认都是
id，但万一你用user_id就得改）
中间表要不要单独建模型？看是否要操作中间表数据
如果只是读取用户有哪些角色、给用户批量加角色，不用建中间模型；但一旦要存「创建时间」「状态」「排序」等中间关系字段，就必须建模型，并用 through 显式指定。
例如中间表 sys_user_role 有 created_at 字段：
public function roles()
{
return $this->belongsToMany(Role::class)
->through(UserRole::class);
}
-
UserRole是中间模型，需继承Model，且定义好表名和主键 - 此时
$user->roles返回的集合里，每个Role实例会带一个pivot属性，里面包含UserRole表的字段值 - 不建中间模型时，
pivot只有外键字段；建了之后才能拿到完整中间行数据
关联查询性能和 N+1 问题怎么破
直接访问 $users[0]->roles 会触发额外 SQL 查询，循环 N 个用户就发 N 条 SQL，这就是典型的 N+1。ThinkPHP 提供 with 预加载，但要注意写法：
// ✅ 正确：预加载
$users = User::with('roles')->select();
// ❌ 错误：下面这句不会触发预加载，还是 N+1
$users = User::select();
foreach ($users as $user) {
$user->roles; // 每次都查一次
}
-
with必须在select或find前链式调用，不能后置 - 如果关联字段要筛选（比如只查启用的角色），得用闭包传条件：
with(['roles' => function ($query) { $query->where('status', 1); }]) - 中间表字段参与筛选时，必须用
hasWhere或whereHas，不能直接在with里用where，否则条件会落到Role表上
dd($user->roles()->getSelectSql()) 看它到底生成了什么 SQL，比翻文档快得多。 
