array_map没生效是因为它不修改原数组而只返回新数组，必须接收返回值；常见失效场景包括未赋值、传null回调时数组长度不一、字符串函数名不存在、不支持多维递归、多数组长度不等被截断、关联数组键名丢失等。
array_map 为什么没生效？常见失效场景
直接用 array_map 却发现原数组没变、返回空、或回调函数根本没执行——这不是函数坏了，而是它从不修改原数组，只返回新数组。你必须接收返回值，否则等于白调用。
- 忘记赋值：
$new_arr = array_map(...)不能写成array_map(...); - 传入
null作为回调时，要求所有数组长度一致，否则截断（PHP 7.4+ 会警告） - 传字符串函数名（如
'trim'）时，若函数不存在，会报Warning: array_map(): Argument #2 should be an array，实际是回调失败导致后续参数解析错乱 - 多维数组不会自动递归，
array_map('strtoupper', $arr)对二维数组的子数组无效
单数组 vs 多数组传参：参数数量和对齐逻辑
array_map 支持单数组或多个等长数组，但行为差异很大：单数组时，回调每次接收一个元素；多数组时，每次接收各数组对应位置的元素（类似“拉链”）。
- 单数组：
array_map(fn($v) => $v * 2, [1,2,3])→[2,4,6] - 双数组：
array_map(fn($a,$b) => $a . $b, ['a','b'], ['1','2'])→['a1','b2'] - 数组长度不等时，PHP 以最短为准，多余元素被丢弃，且不报错（容易漏数据）
- 传入关联数组时，键名不保留（返回索引数组），如需保持键名，得用
array_keys+array_values配合重建，或改用foreach
匿名函数里怎么访问外部变量？use 语法避坑
在闭包中用 use 引入变量时，注意默认是按值捕获。如果想在映射过程中动态更新某个计数器或配置，必须显式声明引用。
- 普通变量：
array_map(fn($v) => $v + $offset, $arr)会报Undefined variable，必须写fn($v) use ($offset) => $v + $offset - 需要修改外部变量（如累计）：
use (&$sum)，否则$sum在每次调用中都是原始副本 -
use不能访问$this，类方法中要用[$this, 'method']或提前绑定：$cb = $this->callback(...); array_map($cb, $arr)
性能敏感时别硬套 array_map：替代方案对比
纯遍历+简单计算时，array_map 比 foreach 慢 10%–30%，因为涉及回调栈开销和新数组分配。尤其在大数组或高频调用场景下，差异明显。
立即学习“PHP免费学习笔记（深入）”；
- 只需过滤+转换，考虑
array_walk（可引用修改原数组，但不返回新数组） - 需保持键名或复杂逻辑，直接
foreach更可控：foreach ($arr as $k => $v) { $result[$k] = $v * 2; } - PHP 8.1+ 可用箭头函数简化，但无法 use 引用变量，限制较多
- 第三方库如
ramsey/collection提供惰性映射（LazyCollection），适合超大数组流式处理
真正麻烦的不是语法，是默认不保留键、不递归、不报错截断——这些隐式行为在数据结构稍复杂时就会悄悄出错。
