正确方法是手写递归函数，通过累积前缀拼接键名实现二维（或任意深度）数组扁平化并添加前缀，如['user'=>['name'=>'Alice']]→['user_name'=>'Alice']；array_merge和array_walk_recursive均无法满足完整路径需求。
PHP 二维数组转一维并添加前缀键名，用 array_merge 不行
直接 array_merge 或 array_values 只能扁平化值，完全丢失原始键名，更无法加前缀。真正要的是「保留原键结构、拼接层级路径为新键」，比如 ['user' => ['name' => 'Alice']] → ['user_name' => 'Alice']。
核心思路是递归遍历 + 键名拼接，不能靠内置函数一步到位。
- 必须手写递归或使用
array_walk_recursive配合引用变量收集 -
array_walk_recursive会跳过中间层键（如只访问到name，拿不到user），所以仅适用于「只要叶子节点」的场景 - 若需完整路径（如
user_profile_avatar_url），必须自己实现递归，并传入当前前缀
手写递归函数处理任意深度，前缀用下划线连接
下面这个函数可处理任意嵌套层级，用 $prefix 累积路径，遇到非数组值就写入结果：
function flatten_with_prefix($arr, $prefix = '') {
$result = [];
foreach ($arr as $key => $value) {
$new_key = $prefix === '' ? $key : $prefix . '_' . $key;
if (is_array($value)) {
$result += flatten_with_prefix($value, $new_key);
} else {
$result[$new_key] = $value;
}
}
return $result;
}
调用示例：flatten_with_prefix(['a' => ['b' => 1, 'c' => ['d' => 2]]]) → ['a_b' => 1, 'a_c_d' => 2]。
立即学习“PHP免费学习笔记（深入）”；
- 注意用
+=合并子结果，不是array_merge（后者会重置数字键） - 如果原始键含空格或特殊字符，建议在拼接前用
preg_replace('/[^a-zA-Z0-9_]/', '_', $key)过滤 - 该函数不修改原数组，返回全新一维数组
只处理严格二维（一层嵌套），用 foreach + array_merge 更轻量
如果确认输入一定是二维（如数据库查出的 fetch_all(MYSQLI_ASSOC) 结果），没必要递归，直接两层循环更清晰、性能更好：
$flat = [];
foreach ($data as $row) {
foreach ($row as $k => $v) {
$flat[$row['id'] . '_' . $k] = $v; // 假设每行有 'id' 字段作主键前缀
}
}
常见需求变体：
- 用固定字符串作前缀：把
$row['id'] . '_' . $k换成'user_' . $k - 避免键冲突：若多行可能有相同
$k，必须带行标识（如id或索引$i） - 不想要下划线？替换成点号或中划线，但注意 PHP 变量/键名中点号会触发语法警告，建议坚持用下划线
遇到数字键或混合键时，is_array() 判断比 !is_string() 更可靠
有人误以为「非字符串键就是子数组」，但数字键（0, 1）也可能是叶子值，比如 ['tags' => [0 => 'php', 1 => 'mysql']] —— 这里 0 是字符串值，不是嵌套数组。
所以判断是否继续递归，唯一安全方式是 is_array($value)，而不是检查 $key 类型或用 is_string($value) 取反。
- 尤其当数组来自 JSON 解码（
json_decode($str, true)），整数键很常见，且语义上未必代表「结构层级」 - 如果业务明确要求「所有数字键都展开」，那得额外约定规则，但不属于通用扁平化逻辑
array_walk_recursive 硬凑路径，该手动就手动。 
