array_splice() 是在指定索引处插入子数组的最直接方案：array_splice($arr, $offset, 0, $subarray) 在 $offset 位置插入 $subarray，不删除元素，数值键重排、关联键保留。
用 array_splice() 在索引位置插入子数组
PHP 没有原生的「在第 N 位插入一个数组」函数，但 array_splice() 是最直接、最可控的方案。它能精准切开原数组，在指定索引处插入新元素（包括子数组），且不改变后续键名顺序（数值键会重排，关联键保留）。
常见错误是误用 array_merge() 或 + 运算符——它们只能拼接在末尾或按键覆盖，无法实现「中间插入」。
-
array_splice($arr, $offset, 0, $subArray)：第三个参数为0表示不删除任何元素，第四个参数是要插入的子数组 - 索引从
0开始；若$offset超出范围（如大于数组长度），会自动追加到末尾 - 注意：该操作直接修改原数组，如需保留原数组，请先
$newArr = $arr赋值副本
```php $users = [['id'=>1,'name'=>'Alice'], ['id'=>3,'name'=>'Charlie']]; $sub = [['id'=>2,'name'=>'Bob']]; <p>array_splice($users, 1, 0, $sub); // 在索引 1 处插入 // 结果：[ ['id'=>1,'name'=>'Alice'], ['id'=>2,'name'=>'Bob'], ['id'=>3,'name'=>'Charlie'] ]</p><pre class="brush:language-;toolbar:false;">
往关联数组的「某个键之后」插入子数组？没有内置方法
PHP 关联数组本身无序（尽管遍历时保持插入顺序），所以「在键 'foo' 后插入」不是语言层面的概念，而是业务逻辑需求。你需要先定位目标键的索引位置，再用 array_splice()。
关键点在于：必须把关联数组转为数值索引数组才能定位位置。
- 用
array_keys($arr)获取所有键，array_search('target_key', array_keys($arr))找到目标键的数值下标 - 插入位置通常是该下标 + 1（即「之后」），但要检查是否越界
- 插入后，新元素会获得新的数值索引，原关联键不受影响
```php
$data = ['header' => 'top', 'body' => 'content', 'footer' => 'bottom'];
$keys = array_keys($data);
$pos = array_search('body', $keys);
if ($pos !== false) {
$toInsert = ['ad' => 'banner'];
array_splice($data, $pos + 1, 0, $toInsert);
}
// 结果：['header'=>'top', 'body'=>'content', 'ad'=>'banner', 'footer'=>'bottom']
```
用 array_merge() 拼接时为什么子数组总被展开？
因为 array_merge() 的设计就是扁平化合并：它把每个参数当作「待合并的顶层数组」，而不是「一个要整体插入的元素」。如果你传入一个子数组，它会把子数组里的每个键值对拆出来，和原数组逐个合并。
这是最容易踩的坑——你以为 array_merge($a, [$b]) 是插入一个子数组，实际效果等价于 array_merge($a, $b)（如果 $b 是一维关联数组）。
- 想插入「整个数组作为一个元素」，必须用
array_splice()或手动切分 + 合并 - 手动方式示例：
array_merge(array_slice($arr, 0, $n), [$subArray], array_slice($arr, $n))，但注意这会让$subArray成为一个独立元素（即嵌套一层），而array_splice()是展开插入 - 性能上，
array_splice()原地操作更轻量；手动array_slice+array_merge会创建多个临时数组
多维数组嵌套插入时要注意键冲突
当你用 array_splice() 往一个数值索引数组中插入子数组，子数组如果是关联结构（如 ['name'=>'X', 'age'=>25]），它会被当作一个普通元素插入，不会引发键冲突。但如果子数组本身含数字键，且你期望它融入父数组的数值序列，就得小心了。
-
array_splice()插入的是「值」，不是「键值对映射」；子数组的内部键完全保留，不会和父数组的数字键合并 - 例如插入
[0=>'first', 1=>'second']到索引1，结果中它就是一个独立元素，其内部0和1不会影响外层数组的索引编号 - 只有当你用
+或array_merge()合并两个数值数组时，才可能因键重复导致覆盖（后者会重排数字键，前者保留左边）
真正容易被忽略的是：插入后遍历数组时，如果依赖 foreach($arr as $i => $v) 中的 $i 是连续整数，要确认插入没破坏这个假设——array_splice() 会重排数值键，但仅限被操作的那部分，行为可预测；而手动拼接容易遗漏重排逻辑。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
