在ThinkPHP 8.0中，关联查询字段裁剪必须在关联定义内部或with()闭包中显式指定，不可用主模型field()写点号语法；外键字段必须包含，多层关联需逐级声明，JOIN方式更可控但丢失模型钩子。
在 ThinkPHP 8.0 中查询用户列表时，发现接口响应慢、内存占用高，排查后发现每次关联 profile 表都返回了全部 12 个字段，而业务实际只需要 nickname 和 avatar 两个字段——这时必须在关联查询阶段就精准控制字段输出，不能依赖后期 array_filter 或 toArray 后处理。
关联字段裁剪必须作用于关联模型本身
ThinkPHP 的 with() 方法默认不识别主模型链式调用的 field()，【User::with('profile')->field('id,name,profile.nickname') 会直接报错或静默忽略 profile.nickname】。这是因为 field() 是主模型 Query 的方法，它只解析当前模型字段名，点号语法（如 profile.nickname）不被支持，底层会当作未知列丢弃。
真正生效的裁剪位置只有两个：关联方法定义内部，或 with() 的闭包参数中。
在 User 模型中定义 profile 关联时，末尾追加 ->field() 即可固化裁剪逻辑：
立即学习“PHP免费学习笔记（深入）”；
public function profile()
{
return $this->hasOne(Profile::class)->field(['id', 'user_id', 'nickname', 'avatar']);
}
注意：user_id 是外键字段，【必须显式包含，否则关联数据无法绑定到主模型，结果为 null】。
运行时动态指定关联字段（闭包方式）
当不同接口对关联字段需求不同时，硬编码 field() 不够灵活。此时应使用 with() 的闭包预载形式，在查询发起时决定字段范围。
方法一：基础闭包裁剪
$user = User::with(['profile' => function ($query) {
$query->field(['user_id', 'nickname']);
}])->find(123);
方法二：配合条件筛选（TP8.0+ 支持）
$user = User::with(['profile' => function ($query) {
$query->where('status', 1)
->field(['user_id', 'nickname', 'avatar']);
}])->find(123);
方法三：多关联混合控制
$users = User::with([
'profile' => function ($q) { $q->field(['user_id', 'nickname']); },
'posts' => function ($q) { $q->limit(3)->field(['id', 'title', 'user_id']); }
])->where('status', 1)->select();
注意：闭包中的 field() 只能写字段名，不能带表前缀（如 profile.nickname），否则会被忽略；且每个关联闭包必须独立调用 field()，不可复用同一 $query 实例。
三层关联字段逐级裁剪
当存在 User → Profile → AvatarLog 这样的嵌套关系时，字段裁剪需逐层显式声明，不能只在第一层 with() 中设置。
第一步：确认 Profile 模型已定义 avatarLog 关联方法，并在其中完成字段限定
public function avatarLog()
{
return $this->hasOne(AvatarLog::class)->field(['id', 'profile_id', 'url', 'created_at']);
}
第二步：在 User 查询中启用两级 with()
$user = User::with(['profile.avatarLog'])->find(123);
第三步：若需运行时控制 Profile 和 AvatarLog 的字段，则必须双层闭包嵌套
$user = User::with([
'profile' => function ($q1) {
$q1->field(['user_id', 'nickname'])
->with(['avatarLog' => function ($q2) {
$q2->field(['profile_id', 'url']);
}]);
}
])->find(123);
这一步操作起来很简单，直接把闭包套进去就行。但若漏掉 avatarLog 的外键 profile_id，最终 $user->profile->avatarLog 就是 null，而不是空对象或空数组——这是最容易踩的坑，调试时难以定位。
JOIN 方式替代 with() 实现字段强约束
当性能敏感且不需要模型事件、自动类型转换时，手动 join() 比 with() 更可控，field() 也更直观。
先 alias() 给关联表起别名，再 field() 显式列出所有需要字段（含主表字段）：
$users = User::alias('u')
->join('profile p', 'u.id = p.user_id')
->field('u.id,u.name,p.nickname,p.avatar')
->where('u.status', 1)
->select();
注意：field() 中必须写全表前缀，否则 ThinkPHP 会误判为只查主表字段，导致 p.nickname 等关联字段丢失；同时两张表若都有 id 字段，不加前缀就会冲突，PDO 可能只返回一个 id 值。
这种方式绕过了模型关联机制，不触发关联模型的 getAttr()、setAttr()、toJson() 等钩子，datetime 字段也不会自动转为 Carbon 实例——如果业务依赖这些特性，就不能用 join() 替代。
