array_walk_recursive不能新增字段，因其仅遍历叶子节点且参数为值副本，无法修改原数组结构；应改用递归array_map或foreach引用赋值。
用 array_walk_recursive 不能新增字段，别踩这个坑
array_walk_recursive 只能遍历到「叶子节点」，且传入的回调函数里接收到的是值的副本，无法通过引用修改原数组结构，更没法给中间层级的子数组加新键。它适合只读操作，比如统一格式化字符串值，但绝不适合“给每项加字段”这种结构变更需求。
常见错误现象：array_walk_recursive($arr, function(&$v) { $v['new_field'] = 'default'; }); 执行完数组完全没变，或者只在最深层字符串/数字上报错（因为字符串不支持下标赋值）。
推荐方案：用 array_map + 递归函数处理嵌套数组
核心思路是把“给每一项加字段”定义为：对每个子数组（包括顶层），都执行 array_merge(['new_field' => $value], $item)；如果是非数组值，保持原样或跳过。关键是要保留原始键名和嵌套关系。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 写一个递归函数，判断当前项是否为数组，是则先加字段再递归处理每个子项
- 用
array_map配合该函数处理顶层，避免直接修改原变量导致引用问题 - 如果需要原地修改，函数参数必须用
&$item引用传递
示例（返回新数组）：
function addFieldToAllArrays($arr, $key = 'new_field', $value = null) {
return array_map(function($item) use ($key, $value) {
if (is_array($item)) {
$item = array_merge([$key => $value], $item);
return addFieldToAllArrays($item, $key, $value);
}
return $item;
}, $arr);
}
如果只要顶层和一级子数组加字段，用 foreach 更直白
很多实际场景并不需要无限递归——比如 API 返回的 data 是对象列表，每个对象是关联数组，只需给这批对象加字段。这时硬套递归反而绕路。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 用
foreach ($arr as &$item)直接引用修改，效率高、逻辑清晰 - 加字段前用
is_array($item)做类型守卫，避免对字符串或数字报错 - 注意 PHP 7.4+ 支持箭头函数，但不支持引用，所以不能用
array_map(fn($x) => [...$x, 'k' => 'v'])替代
示例（原地修改）：
foreach ($data as &$item) {
if (is_array($item)) {
$item['updated_at'] = date('c');
}
}
unset($item); // 必须 unset 引用，否则下次循环可能污染
性能与兼容性提醒：别在大数组里用 array_merge 频繁重建
array_merge 每次都会创建新数组并拷贝全部键值，在深度嵌套+大数据量时（比如上千个元素的三层数组），CPU 和内存开销明显高于直接赋值 $item['key'] = $val。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 优先用
$item['new_key'] = $val而非array_merge(['new_key' => $val], $item) - 如果字段值依赖当前上下文（如带索引的序号），在
foreach中用key()或额外计数器比递归函数更容易控制 - PHP 8.1+ 支持
array_key_first/array_key_last，但跟加字段无关，别误用
最容易被忽略的一点：多维数组里混有对象、null、资源等类型，is_array 守卫必须写全，否则 foreach 会警告或中断。
