PHP unset() 刪除陣列元素完整指南：索引不重建的陷阱與解法

unset() 是 PHP 中刪除變數或陣列元素的核心函數，但其「不重建索引」的特性常導致後續 foreach 遍歷、索引存取出現邏輯錯誤。本文詳細解析 unset() 行為，並提供 array_values()、array_splice() 等重建索引的最佳方案。

核心行為：刪除元素但保留原索引

當使用 unset($arr[$key]) 刪除陣列元素時，PHP 僅移除該鍵值對，不會自動重新排序數字索引。這意味著陣列會出現「索引斷層」。

實例演示

<?php
$arr = ['朝陽區', '海澱區', '西城區', '東城區', '豐台區'];
// 索引: 0, 1, 2, 3, 4

unset($arr[3]);  // 刪除 '東城區'

print_r($arr);
?>

輸出結果：

Array
(
    [0] => 朝陽區
    [1] => 海澱區
    [2] => 西城區
    [4] => 豐台區   // 索引 3 消失，直接跳到 4
)

常見問題場景

1. 索引存取失效

<?php
echo $arr[3];  // Notice: Undefined offset: 3
?>

2. count() 與索引不符

<?php
count($arr);  // 返回 4
// 但最大索引為 4，若用 for 迴圈 $i < count($arr) 會漏掉 $arr[4]
?>

3. JSON 編碼產生稀疏陣列

<?php
json_encode($arr);  
// 輸出: {"0":"朝陽區","1":"海澱區","2":"西城區","4":"豐台區"}
// 前端 JS 解析時 length 為 5，索引 3 為 undefined
?>

三種重建索引方案對比

方案一：array_values() —— 最簡潔通用

<?php
$arr = array_values($arr);
// 結果: [0=>'朝陽區', 1=>'海澱區', 2=>'西城區', 3=>'豐台區']
?>

• ✅ 適用於所有陣列（關聯/數字索引）
• ✅ 保持元素順序
• ⚠️ 會丟棄原有字串鍵名（關聯陣列變數字索引）

方案二：array_splice() —— 精確控制範圍

<?php
// 刪除索引 3 並自動重建
array_splice($arr, 3, 1);
// 等同於: unset($arr[3]); $arr = array_values($arr);
?>

• ✅ 原地修改，無需重新賦值
• ✅ 可批量刪除連續區間
• ⚠️ 僅適用數字索引陣列

方案三：foreach + 新陣列 —— 保留關聯鍵名

<?php
$newArr = [];
foreach ($arr as $k => $v) {
    if ($k !== 3) $newArr[$k] = $v;  // 保留原鍵名
}
?>

• ✅ 完全保留字串鍵名結構
• ✅ 可加入複雜過濾邏輯
• ⚠️ 程式碼較冗長

效能對比建議

最佳實踐檢查清單

1. 刪除後立即重建：若後續需索引存取，緊接 array_values()
2. 優先用 array_splice()：明確刪除位置且為數字索引時
3. 避免 for 迴圈遍歷：改用 foreach 或 array_filter() 避免索引斷層問題
4. API 輸出前處理：json_encode() 前確保索引連續，或用 array_values() 強制轉列表

理解 unset()「不重建索引」的設計初衷（效能考量），並掌握對應的重建策略，能有效避免陣列操作中的隱性 Bug，寫出更健壯的 PHP 程式碼。