正确方法是手写递归函数，通过累积前缀拼接键名实现二维（或任意深度）数组扁平化并添加前缀，如['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]。

• 注意用 += 合并子结果，不是 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)），整数键很常见，且语义上未必代表「结构层级」
• 如果业务明确要求「所有数字键都展开」，那得额外约定规则，但不属于通用扁平化逻辑

实际用的时候，先看数据结构深度和键名来源——是 API 返回的嵌套对象？还是 MySQL 多表 JOIN 结果？前者大概率要递归，后者往往二维就够了。别为了“通用”硬套递归，也别用 array_walk_recursive 硬凑路径，该手动就手动。