### [PHP使用foreach修改数组元素的注意事项：踩坑预警与正确姿势（附PHP 7.4+新语法）](https://www.huociguo.com/article/929)

**Published:** 2026-08-26T14:16:37

**Author:** 米了

**Excerpt:** PHP开发中，数组遍历与修改是高频操作。许多开发者习惯使用 循环处理数组，却常遇到“明明在循环里赋值了，数组却…

PHP开发中，数组遍历与修改是高频操作。许多开发者习惯使用`foreach`循环处理数组，却常遇到“明明在循环里赋值了，数组却纹丝不动”的诡异现象。这种问题并非PHP的Bug，而是对`foreach`底层机制理解不足导致的。

![](https://api.huociguo.com/wp-content/uploads/2026/08/20260826221613243-26141c45c8-1.png "20260826221613243-26141c45c8-1")

### 🔥 为什么这样改不动数组？

先看一段看似“正确”的代码：

```php
$arr = [1, 2, 3];
foreach ($arr as $v) {
    $v = $v * 2; // 试图将每个元素翻倍
}
print_r($arr); // 输出：Array ( [0] => 1 [1] => 2 [2] => 3 )
```

**结果：数组元素没有任何变化！**

原因在于：`foreach ($arr as $v)`中的`$v`是数组元素的**值拷贝**（值传递）。修改`$v`只是修改了这个临时变量，原始数组完全不受影响。这就像复印了一份文件在上面涂改，原件当然不会改变。

### ✅ 正确一：使用引用传递（&）  

这是最直接的解决方案——通过引用传递元素：

```php
$arr = [1, 2, 3];
foreach ($arr as &$v) {
    $v = $v * 2; // 直接修改引用指向的原始元素
}
unset($v); // ⚠️ 关键：遍历结束后立即销毁引用
print_r($arr); // 输出：Array ( [0] => 2 [1] => 4 [2] => 6 )
```

**⚠️ 核心注意事项：**

|     |     |
| --- | --- | 
| 注意点 | 说明  |
| **必须unset引用**​ | 遍历结束后`$v`仍引用数组最后一个元素，若不`unset`，后续对`$v`的赋值会意外修改数组末尾值 |
| **避免嵌套foreach**​ | 外层和内层都使用引用时，引用链会变得极其混乱，极易产生难以排查的Bug |
| **foreach结束后引用残留示例**​ | `$arr = [1]; foreach($arr as &$v){} $v = 99; print_r($arr); // [99]` |

### ✅ 正确二：通过键名直接修改原数组  

利用`$key => $value`语法，直接操作原数组：

```php
$arr = [1, 2, 3];
foreach ($arr as $k => $v) {
    $arr[$k] = $v * 2; // 通过键名定位并修改原数组
}
print_r($arr); // 输出：Array ( [0] => 2 [1] => 4 [2] => 6 )
```

**优点：**​ 无引用残留风险，代码更安全，可读性也更好。

**缺点：**​ 每次赋值都会触发PHP内部的数组写时复制（Copy-On-Write）机制，在超大数组场景下可能有微小性能损耗。

### ✅ 正确三：使用array\_map（函数式写法）  

```php
$arr = [1, 2, 3];
$arr = array_map(function($v) {
    return $v * 2;
}, $arr);
print_r($arr); // 输出：Array ( [0] => 2 [1] => 4 [2] => 6 )
```

**PHP 7.4+ 箭头函数简化版：**

```php
$arr = [1, 2, 3];
$arr = array_map(fn($v) => $v * 2, $arr);
```

**优点：**​ 不可变数据思维，不产生副作用，代码简洁优雅，是函数式编程推荐写法。

### 📊 三种方案对比  

|     |     |     |     |     |
| --- | --- | --- | --- | --- |    
| 方案  | 安全性 | 可读性 | 性能  | 适用场景 |
| 引用传递 `&$v` | ⚠️ 需手动unset | 一般  | ✅ 最优 | 简单遍历修改、超大数组 |
| 键名修改 `$arr[$k]` | ✅ 安全 | ✅ 清晰 | 良好  | 通用场景，最推荐 |
| array\_map | ✅ 最安全 | ✅ 优雅 | 略低（创建新数组） | 函数式风格、转换操作 |

### 🔍 深度补充：foreach的底层行为  

**PHP 7 之前 vs PHP 7+ 的差异：**

-   **PHP 5.x**：`foreach`遍历的是数组的副本，修改原数组不会影响遍历过程
    
-   **PHP 7+**：`foreach`直接遍历原数组，若在循环中`unset`当前元素，下一次迭代会跳过下一个元素（因为内部指针已前进）
    

```php
// PHP 7+ 中的坑
$arr = [1, 2, 3];
foreach ($arr as $k => $v) {
    echo $v . ' ';
    if ($k === 0) unset($arr[1]); // 输出：1 3（跳过了2）
}
```

### 💡 实用建议  

1.  **日常开发首选** `$arr[$k]` **方式**，安全且直观
    
2.  **追求极致性能且数组巨大时**，用引用传递，但务必在循环后`unset`
    
3.  **代码审查时**，看到`foreach`中使用`&`却没`unset`，应标记为潜在风险
    
4.  **PHP 7.4+ 项目**，优先考虑`array_map + fn()`的声明式写法
    

## 结尾  

`foreach`修改数组元素的核心在于理解**值传递与引用传递的本质区别**。引用方式虽高效但暗藏残留风险，键名方式安全通用，函数式写法优雅现代。根据项目场景选择最合适的方案，并在代码审查中重点关注引用遍历后的`unset`操作，即可彻底规避这一经典陷阱。

**Tags:** foreach遍历, PHP7.4新特性, PHP教程, 数组修改

**Categories:** PHP教程

---