array_merge对索引数组重排键名、关联数组保留键名且后者覆盖前者;混合时数字键重排、字符串键独立;需保留原数字键应改用+运算符。

array_merge 合并后键名被重排?用对场景才不会丢数据
PHP 的 array_merge 对索引数组(数字键)和关联数组(字符串键)行为完全不同:索引键会被重新编号,而字符串键会保留原值、冲突时后者覆盖前者。这不是 bug,是设计如此——但很多人没意识到自己传的是索引数组,结果发现 key 全变了。
- 如果你合并的是
['a', 'b']和['c', 'd'],结果是[0 => 'a', 1 => 'b', 2 => 'c', 3 => 'd'],不是[0 => 'a', 1 => 'b', 0 => 'c', 1 => 'd'] - 如果你合并的是
['id' => 1, 'name' => 'A']和['name' => 'B', 'age' => 25],结果是['id' => 1, 'name' => 'B', 'age' => 25] - 混合使用时更危险:比如
array_merge([1, 2], ['name' => 'x']),结果是[0 => 1, 1 => 2, 'name' => 'x']—— 数字键照常重排,字符串键独立存在
想保留数字键不重排?别用 array_merge,改用 + 运算符
当你要“叠加”两个索引数组且不想丢掉原始下标(比如批量收集日志条目、拼接分页结果),array_merge 就不合适。PHP 的数组加法 + 是按键合并,相同数字键不会覆盖,而是跳过后者;它只对「左侧不存在的键」生效。
-
[0 => 'a', 1 => 'b'] + [0 => 'x', 1 => 'y', 2 => 'z']→[0 => 'a', 1 => 'b', 2 => 'z'] - 注意:
+不递归,也不处理嵌套;遇到同名字符串键,左边值永远胜出 - 如果必须递归合并(比如配置数组),用
array_replace_recursive,不是array_merge
空数组或非数组参数传给 array_merge 会警告
array_merge 要求所有参数都是数组。传 null、false、字符串或未定义变量,会直接触发 Warning: array_merge(): Expected parameter X to be an array。线上环境可能因此暴露错误,或让后续逻辑中断。
- 常见写法:
array_merge($a ?? [], $b ?? [])或is_array($a) ? $a : [] - 不要依赖
@array_merge(...)抑制警告——掩盖问题比修复更危险 - Laravel 等框架的
Arr::merge()内部做了类型兜底,但原生 PHP 没这层保护
性能敏感场景慎用 array_merge 多次调用
每次 array_merge 都要复制全部元素。循环里反复合并小数组(比如逐条 push 到结果集),时间复杂度会从 O(n) 退化成 O(n²)。尤其在处理几百个以上数组时,差异明显。
立即学习“PHP免费学习笔记(深入)”;
- 替代方案:先用
[]初始化空数组,再用[] = $item或array_push追加 - 如果必须合并多个已知数组,把它们放进一个二维数组再
call_user_func_array('array_merge', $list),比循环调用高效 - PHP 7.4+ 支持展开语法:
[...$a, ...$b, ...$c],语义清晰、性能接近原生 C 实现,但只适用于一维
真正容易被忽略的,是键类型混用时的隐式转换:比如 '0'(字符串)和 0(整数)在 array_merge 中被视为不同键,但在 + 中会被当作相同键处理。这种差异在动态构造数组时特别致命,调试起来往往要翻半天文档。










