array_merge(...$arr)仅在所有子数组为纯数字索引且不关心键重叠时能保序展平二维数组;含字符串键会覆盖、空数组报错、稀疏索引被重排,存在多重风险。

直接说结论:用 array_merge(...$arr) 可以把二维数组转成一维且保持原顺序,但仅适用于「所有子数组都是数字索引、且不关心键名重叠」的场景;一旦有字符串键、空子数组、或需要保留原始键名逻辑,它就会出错或丢数据。
为什么 array_merge(...$arr) 看似简洁却容易翻车
PHP 的展开操作符 ... 会把二维数组每个子数组作为独立参数传给 array_merge(),而 array_merge() 对数字键是「重新索引」、对字符串键是「覆盖」——这正是保序的关键,也是坑的来源。
- 子数组含字符串键(如
['name' => 'a'])→ 后面同名键会覆盖前面的,顺序还在,但值丢了 - 子数组为空(
[])→array_merge()接收空参数会报Warning: array_merge(): Expected at least 1 parameter, 0 given - 子数组键不是纯数字(如
[0 => 'x', 2 => 'y'])→array_merge()仍会重排为[0 => 'x', 1 => 'y'],表面顺序对,但如果你依赖原始稀疏索引,这就不是你想要的“原顺序”
更稳的写法:用 foreach + array_push(...) 或直接赋值
明确控制每层遍历,不依赖函数的隐式行为,兼容所有键类型,也容易加判断逻辑。
function flatten_2d_keep_order($arr) {
$result = [];
foreach ($arr as $sub) {
if (!is_array($sub)) continue;
foreach ($sub as $item) {
$result[] = $item; // 直接追加,天然保序,不重键也不覆盖
}
}
return $result;
}
- 比
array_merge(...$arr)多几行,但可读性强,调试方便 - 自动跳过非数组元素(比如中间混了个字符串或 null),不会报错
- 如果需要保留原始键(如
[0][0] → 'key_0_0'),也能轻松改造成带键名拼接的版本
遇到关联键又想保序?别硬套 array_merge,用 array_values 收尾
如果你的二维数组其实是「带字符串键的列表」,比如从 JSON 解析来的结构:[["id"=>1,"v"=>"a"], ["id"=>2,"v"=>"b"]],而你只关心值的顺序,不care键名,那可以先提取值再合并:
立即学习“PHP免费学习笔记(深入)”;
$flattened = [];
foreach ($data as $row) {
$flattened = array_merge($flattened, array_values($row));
}
-
array_values($row)强制转成数字索引,消除字符串键干扰 - 外层仍用
array_merge是为了拼接,但已无覆盖风险 - 注意:这里
array_merge的第一个参数必须初始化为数组(如[]),否则第一次调用会警告
真正要保序,核心不是选哪个函数,而是想清楚「你定义的『原顺序』到底指什么」:是子数组的遍历顺序?还是每个子数组内部的键顺序?抑或是键名本身携带的语义顺序?没理清这点,再短的代码也是埋雷。










