ThinkPHP 8.0 中需将查询结果转为 Collection 才能使用 map/filter/unique/reduce 等方法：配置 'resultset_type' => 'collection' 或用 Collection::make() 转换；map 提取转换字段并保留键名，filter 内存筛选，reduce 聚合统计，unique 去重默认重置索引，保键需手动实现。
ThinkPHP 8.0 中拿到模型 select() 返回的数据集后，想对每条记录做字段转换、统计总数、去重筛选或按条件聚合，却卡在不会用 Collection 方法——不是写一堆 foreach，就是误调数据库 where() 导致报错或结果错乱。
先确认你拿到的是 Collection 对象
默认 Db::name('user')->select() 返回二维数组，不支持 map/filter/unique 等方法。必须显式启用 collection 类型：
在 database.php 配置中设置 【'resultset_type' => 'collection'】；或者临时强制转换：$col = \think\Collection::make(User::where('status', 1)->select());
验证是否生效：执行 $col->isEmpty() 不报错且能正确返回 true/false，说明已是 Collection 实例。
立即学习“PHP免费学习笔记（深入）”；
用 map 提取/转换字段（保留空值与键名）
map 不是 array_map 的替代品，它只遍历值，不传入键参数，且默认继承原始键名（如数据库主键 ID 或关联数组字符串键）。
方法一：提取单个字段并转大写
$names = $col->map(fn($u) => strtoupper($u['name'] ?? '')); —— 若某条记录没有 name 字段，?? '' 防止 Notice，返回空字符串而非 null。
方法二：构造新结构，但需手动重置索引
$pairs = $col->map(fn($u) => ['id' => $u['id'], 'label' => $u['name'] . ' (' . ($u['score'] ?? 0) . ')']); → 此时键名仍是原样（如 101、102），若后续要 chunk() 或 JSON 输出需连续数字索引，必须接 ->values()。
【注意：map 闭包里不能写 $u['xxx'] 以外的模型方法，$u 是数组，不是模型实例】
用 reduce 做聚合统计（初始值决定类型）
reduce 不是 for 循环缩写，它必须显式 return $carry，否则下一轮 $carry 变成 null，整个累加中断。
第一步：求所有用户积分总和
$total = $col->reduce(fn($carry, $item) => $carry + ($item['score'] ?? 0), 0); —— 初始值 0 决定了返回整数，若传 [] 就会变成数组拼接。
第二步：统计各状态人数，返回关联数组
$stats = $col->reduce(fn($carry, $item) => [ $item['status'] => ($carry[$item['status']] ?? 0) + 1, ...$carry ], []); —— 这里用展开运算符保持键顺序，但注意 PHP 版本需 ≥7.4；若用旧版，改用传统 if/else 累加。
第三步：找最高分用户（需配合 firstWhere 或自定义逻辑）
$maxScore = $col->reduce(fn($carry, $item) => max($carry, $item['score'] ?? 0), 0); —— 这只返回数值；若要返回整条记录，初始值得设为 null，内部判断替换。
用 filter 做内存筛选（别在回调里查数据库）
filter 是纯内存操作，适合已查出数据后的二次过滤，比如按时间范围、关键词模糊匹配或组合条件。
方法一：精确匹配 status 和 score 区间
$activeHigh = $col->filter(fn($u) => $u['status'] === 'active' && $u['score'] >= 90); —— 注意用 ===，避免 '1' 和 1 混淆。
方法二：模糊搜索 name（不支持 SQL LIKE，得用 PHP 函数）
$search = 'admin'; $matched = $col->filter(fn($u) => stripos($u['name'] ?? '', $search) !== false);
方法三：排除空邮箱且非测试账号
$valid = $col->filter(fn($u) => !empty($u['email']) && strpos($u['email'], '@test.') === false);
【严禁在 filter 回调里调用 Db::table()->find() 或 $model->save()，这会触发 N+1 查询，性能雪崩】
用 unique 去重（默认丢键名，需手动保键）
unique('field') 表面方便，实则破坏原始键映射——它只保证字段值唯一，但保留哪条记录由遍历顺序决定，且键名被重置为 0,1,2…
若需按 user_id 去重并保留每组第一条的原始 ID 键：
① 先排序确保业务优先级（如按 created_at 降序）
② 再 unique('user_id')，此时保留的是最新那条
③ 最后用 values() 强制重排索引（如果前端不需要原始键）
若必须保留原始键名（如前端传 UUID 作 key），放弃 unique()，改用：
$seen = []; $unique = $col->filter(fn($u) => !isset($seen[$u['user_id']]) && $seen[$u['user_id']] = true);
这行代码利用 PHP 赋值表达式返回值特性，在 filter 中边判重边记键，既保原始键又不额外循环。
