操作PHP数组时，删除指定元素是高频需求。很多开发者从接触PHP开始就记住了unset()函数，用它删除元素确实简单，但很快会发现删除后数组的下标没有重新排列，使用foreach遍历也会出现预期之外的情况。要彻底掌握数组删除操作，需要理解不同函数对数组内部结构的影响，这样才能根据业务场景选出最合适的手段。
按key精确删除：unset函数的行为分析
unset是PHP中销毁变量的语言结构，同样适用于数组元素。它的基本用法是unset($array[$key])，其中key可以是整数下标也可以是字符串键名。这种删除方式时间复杂度为O(1)，因为它直接对哈希表中的指定桶进行标记删除，不需要移动其他元素。删除字符串键名数组的元素时，unset是没有争议的首选方案。
但unset处理数字下标数组时有一个显著特点：删除元素后不会重建索引。例如一个数组包含0、1、2三个下标，删掉下标1的元素后，数组里只剩下下标0和2。这在某些需要连续索引的场景下会引发问题。例如把数组传给前端时，如果前端用数组长度做循环遍历，就会出现下标越界或读取到空值的风险。
<?php $fruits = ['apple', 'banana', 'cherry', 'date']; unset($fruits[1]); print_r($fruits); // 输出： // Array // ( // [0] => apple // [2] => cherry // [3] => date // ) ?>
观察上面的输出可以发现，数组在删除元素后，元素个数从4变成了3，但下标不再连续。如果业务逻辑对键名有依赖，比如使用array_map()函数处理该数组，处理结果同样会保留这种断裂的下标结构。因此当程序后续逻辑要求键名必须为0到n-1时，unset不能直接满足需求，要么配合array_values重新索引，要么选择其他删除方法。
删除并重建索引：array_splice的使用要点
array_splice函数的设计目标就是删除数组中的一段元素，并且默认用新的连续下标替换被删除的部分。它的签名是array_splice($array, $offset, $length, $replacement)。其中offset表示从哪个下标开始删除，length表示删除几个元素，replacement可选，用于在被删除的位置插入新元素。它和unset最大的区别在于，被删除元素之后的所有元素会向前移动，索引重新从0开始排列，保证了数组结构的紧凑性。
使用array_splice时需要清楚它操作的是数字索引数组。对于字符串键名的关联数组，array_splice同样可以把键值对当作连续元素删除并重建数字索引，但键名会丢失，因此关联数组删除单个元素时一般优先考虑unset。此外array_splice的offset参数如果为负数，表示从数组末尾开始倒数计算位置；length为负数时会停止在距离数组末尾该数字的位置。这些细节在实际开发中偶尔会用到。
<?php $cities = ['北京', '上海', '广州', '深圳', '杭州']; // 从下标2开始删除2个元素，即删除"广州"和"深圳" array_splice($cities, 2, 2); print_r($cities); // 输出： // Array // ( // [0] => 北京 // [1] => 上海 // [2] => 杭州 // ) ?>
这个例子清楚展示了array_splice删除元素后索引自动重建的过程。数组长度从5减少到3，下标0、1、2连续排列，没有任何空洞。对于需要严格保证数组索引连续性的业务，比如把数组当作队列处理或多次循环迭代时，array_splice比unset更可靠。需要注意array_splice的第一个参数是引用传递，函数内部会直接修改原数组，不会返回新数组，返回值只是被删除元素构成的数组。
如果只想删除一个元素，也可以考虑使用unset配合array_values的组合，效果等价于array_splice删除单个元素后再重建索引。两者的区别在于代码可读性和执行效率。array_values会遍历整个数组并创建新数组，时间复杂度为O(n)，而array_splice在删除中间元素时也需要移动后续元素，最坏同样是O(n)。对于上百万元素的大数组，这点性能差异并不明显，选择哪种方式主要看团队代码风格。
按值删除与循环中的安全操作
很多时候我们并不知道具体下标，只知道要删除的元素的value。此时可以使用array_search()找到对应的key，再配合unset完成删除。假如数组中有多个相同的值需要全部删除，array_search只能返回第一个匹配的键，这时候循环调用并不是高效做法。更好的方案是使用array_diff()函数，它会把第一个数组中和后续参数相同的值全部移除，同时保留原有键名。
<?php $students = ['张三', '李四', '王五', '张三', '赵六']; // 把所有值为"张三"的元素全部删除 $result = array_diff($students, ['张三']); print_r($result); // 输出： // Array // ( // [1] => 李四 // [2] => 王五 // [4] => 赵六 // ) ?>
array_diff返回的数组键名仍然保持原样，可以看到下标0和3被移除后，剩下元素的key没有重新排序。如果希望删除值之后彻底重建索引，可以再套一层array_values。假设要删除不只是一个值而是多个指定值，array_diff只需要在第二个参数里多列举几个值即可。与之相比，如果要实现同样的效果只靠unset逐个删除，代码会冗余很多。
在foreach循环中删除元素是另一个经典陷阱。直接在foreach ($array as $item)中使用unset($item)无法删除原数组元素，因为$item是复制值而不是引用。正确做法有两种：一种是遍历键名，用foreach ($array as $key => $value)获取键名后unset原数组对应键；另一种是把$value声明为引用，即foreach ($array as &$value)，不过这种方式在循环结束后需要手动unset掉$value引用，以免后续代码误修改数组元素。
<?php
$numbers = [1, 2, 3, 4, 5, 6];
// 删除所有偶数元素
foreach ($numbers as $key => $value) {
if ($value % 2 === 0) {
unset($numbers[$key]);
}
}
print_r($numbers);
// 输出：
// Array
// (
// [0] => 1
// [2] => 3
// [4] => 5
// )
?>
循环内使用unset删除元素时，PHP的foreach底层会基于数组内部指针工作，unset正在遍历的那个键不会导致foreach报错，也不会跳过后面元素，因为foreach在每次迭代时都会更新内部指针。但如果需要删除大量元素，这种做法会产生很多键空洞，可以考虑先收集需要删除的键名数组，循环结束后统一用unset批量删除。这样代码逻辑更清晰，也有利于后续维护。
关联数组删除某个指定字段时使用unset最直接，比如从用户信息数组中移除密码字段unset($user['password'])。而删除有序列表中的中间某个位置元素时，array_splice更合适。至于按值删除，则需要区分是删除第一个匹配项还是全部匹配项，前者用array_search加unset，后者用array_diff。没有一种方法能够通吃所有场景，只有结合数组下标类型、索引是否需要重建、删除条件是否为值这三个维度来选择。
综合来看，PHP数组删除元素并没有绝对的银弹方案。unset的语法最简洁，array_splice在连续索引场景下表现更好，array_diff则为值匹配删除提供了优雅的实现路径。搞清楚这些函数各自的内部处理逻辑，写出的代码不仅正确率高，在可读性和团队协作上也会加分。
PHP数组unsetarray_splice修改时间：2026-08-24 03:55:39