map、filter、reduce 非语法糖，其闭包逻辑与返回值规则直接影响结果：filter 用 falsy 判定致 status=0 被误删；map 多行须显式 return；reduce 必传初始值防空集合报错；所有方法默认返回新实例，仅 transform 就地修改。
别把 map、filter、reduce 当成语法糖来用，它们的闭包执行逻辑和返回值规则直接决定结果是否符合预期——写错一个 return 或漏判 0，集合就 silently 变成空或错位。
filter() 为什么突然删掉了 status=0 的用户？
因为 filter() 判定依据是 PHP 的 truthy/falsy，不是严格布尔。闭包返回 0、''、false、null 都会被剔除，不区分业务含义。
- 错误写法：
$users->filter(fn($u) => $u['status'])—— status 字段为0时整条记录消失 - 正确写法：
$users->filter(fn($u) => $u['status'] === 0 || $u['status'] === 1) - 更安全的替代：
$users->where('status', 0)->merge($users->where('status', 1))，避免闭包类型陷阱 - 如果只是想排除 null/undefined，优先用
whereNotNull('status')，它不碰0和''
map() 返回全是 null？检查 return 和箭头函数边界
map() 不会自动返回闭包最后一行值，多行逻辑必须显式 return；单行箭头函数虽隐式返回，但一旦加了花括号就失效。
- 危险写法：
$users->map(fn($u) => { $u['name'] . ' (active)'; })→ 全是null - 安全写法（单行）：
$users->map(fn($u) => $u['name'] . ' (active)') - 安全写法（多行）：
$users->map(fn($u) => { return $u['name'] . ' (active)'; }) - 若需保持键名连续（比如后续要
slice()分页），记得接values()，否则过滤后可能留下稀疏索引
reduce() 初始值不传？空集合直接报错
reduce() 没传初始值时，会取第一项作为 $carry，但若集合为空，PHP 报 Undefined offset: 0，且无法被 try/catch 捕获（底层是 ArrayAccess 异常）。
- 永远显式传初始值：
$sum = $items->reduce(fn($carry, $item) => $carry + $item['price'], 0) - 初始值类型决定返回类型：传
[]得数组，传collect()得 Collection，传''得字符串 - 别在
reduce里调外部变量或改状态——它设计为纯累积，副作用会导致不可预测结果 - 聚合结构建议优先用现成方法：
sum('price')、avg('score')更稳，reduce留给复合逻辑（如按条件累加不同字段）
最易被忽略的是：所有这些方法默认返回新实例，原集合不动；但 transform() 是唯一就地修改的例外——链式中混用时，你以为 $col->filter()->transform() 改了原始数据，其实只改了中间那个新实例，原始 $col 完全没变。
