PHP二维数组转一维不能仅用array_merge(...$arr)，因其仅扁平化一层、丢键名、遇非索引数组报错；推荐array_walk_recursive()提值，或手写递归拼键名，避免JSON+正则等不可靠方案。
PHP 二维数组转一维，不能只用 array_merge(...$arr) 硬展开——它对三层及以上直接失效，还会丢键名、报 Warning。
为什么 array_merge(...$arr) 在深层嵌套下会出错
这个写法本质是「扁平化一层」：它把数组的每个子项当作一个参数传给 array_merge，仅适用于「所有子项都是索引一维数组」的严格二维场景。
常见错误现象：
- 遇到
['a' => ['x' => 1]]，array_merge(...$arr)报Warning: array_merge(): Argument #1 is not an array - 遇到
[[1,2], [3, [4,5]]]，结果变成[1,2,3,[4,5]]，第四层没动 - 键名丢失：
['k' => [1,2]]展开后变成[0 => 1, 1 => 2]，原始'k'消失
用 array_walk_recursive() 最快降维（保留值，丢弃键路径）
这是 PHP 原生最轻量的递归展平方案，只提取叶子节点的值，不关心层级和键名。
立即学习“PHP免费学习笔记（深入）”；
实操建议：
- 适用场景：你只想要所有最终值（比如收集全部 ID、全部字符串），不关心它们原来在哪层、叫什么键
- 它自动跳过函数、对象、资源，安全；但也会跳过空数组（因为空数组没有“叶子”）
- 别试图用它保留键路径——它压根不提供父键信息
示例：
$arr = ['a' => [1, 'b' => [2, 3]], 'c' => [[4], 5]];
$result = [];
array_walk_recursive($arr, function($v) use (&$result) {
$result[] = $v;
});
// $result === [1, 2, 3, 4, 5]
手写递归函数控制键名与结构（推荐用于 API 返回降维）
当你要把 ['user' => ['profile' => ['name' => 'A']]] 变成 ['user_profile_name' => 'A']，就必须自己遍历并拼键名。
关键点：
- 必须传引用参数保存结果，或 return 合并后的数组（避免反复 copy 大数组）
- 用
is_array()判断是否继续递归，别用isset($v['xxx'])之类误判 - 键名拼接建议用
$prefix . '_' . $key，但注意空字符串前缀、数字键（如0）要不要参与拼接 - 性能敏感时，避免在递归里做
array_merge()，改用$result[$newKey] = $value直接赋值
简短示例（下划线拼接，跳过数字键）：
function flattenWithKeys(array $arr, string $prefix = '', array &$result = []): array {
foreach ($arr as $key => $value) {
$newKey = $prefix === '' ? (is_string($key) ? $key : '') : $prefix . '_' . $key;
if (is_array($value)) {
flattenWithKeys($value, $newKey, $result);
} else {
if ($newKey !== '') $result[$newKey] = $value;
}
}
return $result;
}
用 json_encode + 正则不是好主意
网上有「转 JSON → 正则匹配引号内值」的野路子，看似能绕过递归，实际问题一堆：
- 字符串里含双引号、反斜杠、Unicode 会破坏 JSON 结构，正则直接抓错
- 数字、
null、布尔值会被当成字符串提取，类型丢失 - 无法区分同名键在不同层级（比如两个
"id"，你不知道哪个是用户 ID、哪个是订单 ID） - 比原生递归慢至少 3 倍，且内存占用翻倍
除非你处理的是已知干净、无嵌套字符串的纯数字配置，否则别碰。
深层嵌套降维真正的难点不在“怎么写递归”，而在于明确你要保留什么：是只要值？要带路径的键？还是需要按某种规则过滤中间层？没想清这点，代码越写越像补丁。
