collect() 创建集合需避坑：传 null 得空集致后续操作静默失败，字符串/对象抛 TypeError，Eloquent 结果勿重复 collect；filter() 基于 truthy 判定，where() 仅严格相等；map() 多行逻辑须显式 return；groupBy() 返回嵌套集合，需链式调用方法而非数组访问。
直接用 collect() 包一层数组，就能获得链式、可读性强、自动处理 null 的集合对象；但别在大数据量时全量加载进内存，也别对 Eloquent 查询结果再套一次 collect()。
collect() 创建集合时的三个坑
传 null 不报错但返回空集合，后续 filter() 或 map() 会静默失败；传字符串或对象则直接抛 TypeError；Eloquent 查询如 User::all() 已是集合，再 collect($users) 属于多余构造，还可能破坏查询上下文。
- 安全写法：始终判空，
collect($request->input('items') ?? []) - JSON 字符串必须先解码：
collect(json_decode($json, true) ?? []) - 从数据库来？直接用：
$users = User::where('active', 1)->get();（它已经是Collection）
filter() 和 where() 到底该选哪个
filter() 看闭包返回值是否为 truthy，0、false、'' 全被干掉；where() 是严格相等（===），只适合简单键值匹配，不支持操作符。
- 要保留
status = 0的记录，别写filter(fn($u) => $u['status'])，改用filter(fn($u) => $u['status'] === 0 || $u['status'] === 1) - 查
name等于'Bob'，用where('name', 'Bob')更清晰 - 查
created_at >= '2025-01-01'？只能用filter()配闭包，where()不认操作符 - 字段存在性检查优先用
whereNotNull('email')，比filter()判空更语义化且 null-safe
map() 返回全是 null？你漏了 return
箭头函数单表达式自动返回，但多行逻辑块里没写 return，PHP 默认返回 null，整个集合就变成一堆 null。
- 安全写法：单行用箭头函数，
map(fn($u) => ['id' => $u->id, 'label' => $u->name]) - 多行必须显式
return：map(fn($u) => { return ['id' => $u->id, 'label' => strtoupper($u->name)]; }) - 想原地修改？用
transform()，但它不返回新实例，链式调用到这里就断了 - 筛选后需要重排数字索引（比如切片后取
[0]），记得接values()，否则$collection[0]会报错
groupBy() 后怎么取某一分组的值
groupBy() 返回的是嵌套集合，不是数组。比如按 status 分组后，$grouped['active'] 是一个子 Collection，不能直接当数组用下标或 count()，但可以继续链式调用 first()、pluck() 等。
- 遍历没问题：
foreach ($grouped['active'] as $item) { ... } - 取第一个元素：
$grouped['active']->first()（前提是键存在） - 提取字段：
$grouped['active']->pluck('name') - 不确定键是否存在？先用
isset($grouped['active'])或$grouped->has('active')判断
最易被忽略的其实是「延迟执行」和「不可下标访问」这两个特性：集合不是数组，->first() 和 ->get(0) 行为不同，foreach 可以，$collection[0] 不行——这点在调试和分页切片时最容易踩空。
