Array_walk_recursive 无法保留层级路径，需手动递归拼接键路径；推荐用 flattenWithKeys 函数以 . 分隔路径，支持对象转换与类型断言，性能敏感时可用路径栈优化。
用 array_walk_recursive 会丢失层级信息
这个函数看似能扁平化多维数组，但它只返回值，不保留键路径。比如 $arr['user']['profile']['name'] 会被压成 'name' => 'Alice'，你根本不知道它原来在第几层、路径是什么。
实际场景中，比如导出配置、生成表单字段名、做权限路径映射，必须知道原始结构位置。这时候不能靠 array_walk_recursive，得自己跟踪路径。
手动递归 + 路径拼接是最可控的方式
核心思路：每进一层，把当前键追加到路径里；到底层（值不是数组）时，用该路径作为新键存入结果数组。
注意点：
立即学习“PHP免费学习笔记（深入）”；
- 用
is_array()判断是否继续递归，别用isset()或!empty()混淆类型 - 路径分隔符建议用
.（如user.profile.name），避免/或\在某些场景（如 jsON key、html data 属性）引发解析问题 - 如果原数组有数字键，
0和'0'会被视为相同，但 php 数组本身允许混合键，所以拼接时统一转为字符串更安全
function flattenWithKeys($arr, $prefix = '') { $result = []; foreach ($arr as $key => $value) { $newKey = $prefix === '' ? (string)$key : $prefix . '.' . (string)$key; if (is_array($value)) { $result += flattenWithKeys($value, $newKey); } else { $result[$newKey] = $value; } } return $result; }遇到对象或特殊类型要提前处理
PHP 数组里混对象很常见（比如 laravel 的 Collection、Doctrine 实体），is_array() 会返回 false，直接跳过导致数据丢失。
如果你的输入可能含对象，得扩展判断逻辑：
- 用
is_object($value) && method_exists($value, '__toArray')尝试转义 - 或统一用
json_decode(json_encode($value), true)强制转数组（适合简单对象，不推荐含资源、闭包等） - 如果明确只处理纯数组，建议开头加断言：
if (!is_array($arr)) { throw new InvalidArgumentException('Expected array, got ' . gettype($arr)); }
性能敏感时避免字符串拼接频繁触发 realloc
深度嵌套数组（比如 10 层+、上万元素）下，每次 $prefix . '.' . $key 都新建字符串，PHP 底层会反复分配内存。实测比预分配路径数组慢 2–3 倍。
优化写法是传引用路径栈：
function flattenWithKeysOpt($arr, &$path = []) { $result = []; foreach ($arr as $key => $value) { $path[] = (string)$key; if (is_array($value)) { $result += flattenWithKeysOpt($value, $path); } else { $result[implode('.', $path)] = $value; } array_pop($path); } return $result; }路径栈复用，减少字符串临时变量。但要注意：这种写法对调试不友好，出错时 $path 状态难追踪，上线前务必覆盖测试边界情况（空数组、单层、全数字键等）。
真正复杂结构降维时，层级信息不是“要不要保留”，而是“怎么定义层级”——是按嵌套深度，还是按语义路径（比如忽略中间的 data 层）？这往往得结合业务规则做定制，通用函数只能打底。