应使用 array_replace_recursive() 实现默认值填充，它递归用右侧非空值覆盖左侧对应键，而非 array_merge_recursive() 的堆叠逻辑；若需兼容旧版PHP，可手写三行递归覆盖函数。
PHP数组合并时默认值被覆盖怎么办
用 array_merge_recursive() 并不能“设置默认值”，它只是把同名键的值自动合并成数组，而不是“左边优先、右边补缺”。想实现默认值逻辑，得换思路——本质是“用右侧数组覆盖左侧的空缺”，不是递归合并。
常见错误现象：array_merge_recursive(['a' => null], ['a' => 'new']) 结果是 ['a' => [null, 'new']]，完全不是你想要的覆盖效果。
- 真正该用的是
array_replace_recursive()：它会递归地用右数组的非-null、非-missing 值替换左数组对应位置的值 - 如果右数组某键存在但值为
null或''，且你希望仍保留左数组的值，就得手动过滤右数组再传入 -
array_merge()只对一维有效，遇到嵌套就失效；array_merge_recursive()专治“要堆叠不要覆盖”的场景，比如日志聚合、多语言词条累加
怎么安全地给嵌套数组设默认值
核心动作是“先定义骨架（默认值），再用用户数据有选择地填充”。不能靠合并函数自动判断“哪个算默认、哪个算配置”。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 把默认值数组写成完整结构（哪怕某些值是占位符如
'id' => 0），避免运行时键缺失 - 用
array_replace_recursive($defaults, $user_input)替代array_merge_recursive() - 如果
$user_input来自$_POST或 API 请求，务必先用array_filter($user_input, function($v) { return $v !== null && $v !== ''; })清洗掉无意义空值，否则array_replace_recursive()会把空字符串也当有效值覆盖掉默认值
示例：$defaults = ['user' => ['name' => 'Anonymous', 'age' => 0]]; + $input = ['user' => ['name' => 'Alice']]; → array_replace_recursive($defaults, $input) 得到 ['user' => ['name' => 'Alice', 'age' => 0]]，符合预期。
为什么 array_merge_recursive 不适合默认值场景
它设计目标就是“不丢数据”，所有冲突键一律转为数组。这在合并配置文件或收集多来源字段时有用，但在表单提交、API参数补全这类“以用户输入为准、仅缺省兜底”的场景里，反而制造麻烦。
典型坑点：
- 数字索引会被重排，
array_merge_recursive([1,2], [3,4])→[1,2,3,4]，但['a'=>1,'b'=>2]和['a'=>3,'b'=>4]合并后变成['a'=>[1,3], 'b'=>[2,4]]，结构彻底改变 - 遇到
null、false、0这类“falsy 但有意义”的值，array_merge_recursive()照样堆进去，不会跳过 - 没有内置机制区分“这个键是用户没传”还是“用户明确传了 null”，而默认值逻辑恰恰依赖这个区分
兼容 PHP 5.3+ 的轻量替代方案
如果你不能用 array_replace_recursive()（比如老项目卡在 PHP 5.2），别硬套 array_merge_recursive()，手写一个最小可用的递归覆盖函数更可靠。
关键逻辑只有三行：
function array_set_defaults($defaults, $input) {
foreach ($input as $k => $v) {
if (is_array($v) && isset($defaults[$k]) && is_array($defaults[$k])) {
$defaults[$k] = array_set_defaults($defaults[$k], $v);
} elseif ($v !== null && $v !== '') {
$defaults[$k] = $v;
}
}
return $defaults;
}
注意：这个函数只覆盖非空非null值，保留 $defaults 的原始结构，且不修改原数组。比强行适配 array_merge_recursive() 更可控。
最易被忽略的一点：默认值逻辑是否要处理 0、false、'0' 这些值？它们不是空，但业务上可能等价于“未填写”。得根据字段语义决定用 !== null 还是 isset() 或 !empty() 判断，不能一概而论。
