laravel collection 是不可变对象，map() 返回新实例而不修改原集合，这是设计原则而非 bug；transform() 才用于就地修改。
Laravel 的 Collection 是不可变对象（immutable），这是 map() 不会修改原集合的根本原因。
它不是 bug，而是设计原则：每次调用 map()、filter()、sortBy() 等方法，都会返回一个全新集合实例，原始集合保持不变。这种设计保障了链式调用的安全性、可预测性和函数式编程风格。
map 为什么不能直接改原集合
-
map()的定位是「转换映射」，不是「就地更新」 - 它遍历每个元素，把回调返回值组装成新集合，原始数据不参与任何写操作
- 即使你在回调里写了
$item['name'] = strtoupper($item['name'])，也只是修改了当前副本，不影响原集合底层数据
想真正改原集合，该用 transform()
transform() 是 Collection 中少数几个明确用于就地修改的方法：
$collection = collect(['hello', 'world']); $collection->transform(fn($item) => strtoupper($item)); // $collection 现在是 ['HELLO', 'WORLD']
注意：transform() 会改变原集合，同时也会返回该集合（便于链式），但它的语义就是“动我本身”。
常见误解和坑点
- ❌
foreach ($collection as &$item) { $item = ... }对 Collection 无效 —— Collection 不支持引用赋值，$item是副本 - ❌
map()后没接values()，导致键名混乱（如[2 => 'a', 5 => 'b']），后续chunk()或splice()行为异常 - ❌ 在
map()回调中修改模型属性（如$user->name = 'X'），虽然模型本身变了，但 Collection 实例里的引用没刷新，且违背不可变原则，容易引发后续逻辑错乱
正确做法建议
- 需要新结构 → 用
map()，再链式处理（如->filter()->values()->all()） - 必须改原变量 → 用
transform()，或重新赋值：$collection = $collection->map(...) - 处理模型集合并提取字段 → 优先用
$users->map->only(['id', 'name'])，比手写回调更安全 - 修改后要重置索引 →
map()后紧跟->values()，尤其当后续要->chunk()、->toArray()或传给upsert()时
Collection 的不可变性让代码更可靠，也避免了隐式副作用。理解这点，就能避开 80% 的“为什么改了没生效”类问题。
