sync() 是“只留这些 id”的全量替换操作，先删后插，非增量更新；适用于权限组等配置型数据，不适用需保留历史的场景。
sync() 不是“把新 ID 加进去”，而是“只留这些 ID”——用错就删数据，不是加数据。
sync() 会清空再插入，不是增量更新
调用 $user->roles()->sync([2, 3]) 时，Laravel 先执行 DELETE，再 INSERT。哪怕用户原本已有角色 [1, 2]，结果只剩 [2, 3]，ID 1 被静默删掉。
- 适合场景：权限组、标签集合这类“当前列表即全部合法值”的配置型数据
- 不适合场景：需要保留历史关联、或仅追加新项（比如用户新增兴趣标签但不取消旧兴趣）
- 想追加不删旧？改用
$user->roles()->attach([3, 4])；想只删不加？用$user->roles()->detach([1])
带额外字段的 sync() 必须传键值对，不能只传 ID 列表
中间表有 activated_at 或 priority 字段时，sync() 不接受纯数组 [1, 3]，否则字段全丢且不报错。
- 正确写法：
$user->roles()->sync([1 => ['activated_at' => now()], 3 => ['activated_at' => now()]]) - 未传字段默认设为 NULL（除非迁移里写了
->useCurrentOnUpdate()或数据库 DEFAULT） - 想部分更新 pivot 字段（比如只改某条记录的
notes，其他不动）？sync()不行，得用updateExistingPivot()单条处理
sync() 前模型必须已保存，否则外键写入 0 或 NULL
$user = new User(['name' => 'Alice']); $user->roles()->sync([1]); 会失败——因为 user_id 是 0 或 NULL，触发 Integrity constraint violation: 1452。
- 正确顺序：
$user = User::create([...]); $user->roles()->sync([...]); - 新建后立刻同步？必须先
save()或create()写入主表，拿到真实主键 - 批量创建多个用户并同步角色？每个用户都得独立完成“创建 → 同步”，不能共用一个未 persist 的实例
syncWithoutDetaching 不是智能去重，而是跳过删除直接插
syncWithoutDetaching([1, 2, 3]) 不会检查 1 是否已存在，它直接对每个 ID 执行 attach()。如果中间表有唯一索引 UNIQUE(user_id, role_id)，重复 ID 就抛 SQLSTATE[23000]: Integrity constraint violation。
- 它不等价于 “安全版 sync”，只是少了一步 DELETE
- 真要幂等追加？自己做前置去重：
collect($newIds)->diff($existingIds)->each(...) - 多数情况不如明确用
attach()+ 手动查重来得可控和可读
最易被忽略的一点：sync() 操作的是 pivot 表，不触发模型自身的 creating/updating 事件，也不走 fillable/casts 校验。业务上需要联动缓存刷新、日志记录或状态变更，必须显式写在 sync() 后面，不能指望它自动广播。
