在 Java 开发中，List 作为最常用的集合类型，广泛应用于数据存储与处理场景。修改 List 中的元素是日常开发的高频操作，不同场景下（已知索引、匹配内容、操作自定义对象）需选择不同的修改方式。本文将从基础到进阶，全面讲解 List 元素的修改方法、避坑要点及最佳实践，结合萌宠场景的示例让新手也能快速理解。
一、核心前提：List 的可修改性
首先需明确：并非所有 List 都支持修改。
- 支持修改的 List：
ArrayList、LinkedList（最常用，继承自AbstractList，实现了List接口的可变集合）； - 不可修改的 List：
Collections.unmodifiableList()创建的列表、List.of()（Java 9+）创建的固定长度列表，调用set()方法会抛出UnsupportedOperationException。
本文所有示例均基于可修改的ArrayList（最通用、性能最优）展开。
二、基础方式：通过索引直接修改（效率最高）
当已知要修改元素的索引位置（索引从 0 开始），使用List.set(int index, E element)方法是最优选择 —— 该方法直接替换指定索引的元素，时间复杂度为 O (1)（ArrayList），是效率最高的修改方式。
1. 基本语法
java
运行
// 核心方法：替换索引index处的元素为新值，返回被替换的旧值 E oldValue = list.set(int index, E newElement);
2. 完整示例（萌宠列表场景）
java运行
import java.util.ArrayList; import java.util.List; public class ModifyListByIndex { public static void main(String[] args) { // 1. 初始化萌宠名称列表 List<String> petNameList = new ArrayList<>(); petNameList.add("金毛"); petNameList.add("布偶猫"); petNameList.add("仓鼠"); petNameList.add("荷兰猪"); System.out.println("修改前列表：" + petNameList); // 输出：[金毛, 布偶猫, 仓鼠, 荷兰猪] // 2. 修改索引1的元素（布偶猫 → 英短猫） String oldPet = petNameList.set(1, "英短猫"); System.out.println("被替换的旧值：" + oldPet); // 输出：布偶猫 System.out.println("修改后列表：" + petNameList); // 输出：[金毛, 英短猫, 仓鼠, 荷兰猪] // 3. 批量修改多个索引元素 petNameList.set(2, "金丝熊"); // 仓鼠 → 金丝熊 petNameList.set(3, "豚鼠"); // 荷兰猪 → 豚鼠 System.out.println("批量修改后：" + petNameList); // 输出：[金毛, 英短猫, 金丝熊, 豚鼠] } }
3. 避坑要点
- 索引不能越界：索引范围必须是
0 ≤ index < list.size()，否则抛出IndexOutOfBoundsException； - 空列表不能修改：调用
set()前需判断!list.isEmpty()，避免空指针或索引越界。
三、进阶方式：匹配元素内容修改（未知索引）
实际开发中，更多场景是知道元素内容但不知道索引，需先遍历列表找到目标元素，再修改。推荐 3 种遍历修改方式，适配不同 Java 版本。
1. 普通 for 循环（最通用，兼容所有 Java 版本）
通过索引遍历列表，匹配元素内容后调用set()修改，支持修改多个匹配项。
java运行
import java.util.ArrayList; import java.util.List; public class ModifyListByLoop { public static void main(String[] args) { List<String> petTypeList = new ArrayList<>(); petTypeList.add("狗狗"); petTypeList.add("猫咪"); petTypeList.add("狗狗"); petTypeList.add("异宠"); System.out.println("修改前：" + petTypeList); // [狗狗, 猫咪, 狗狗, 异宠] // 遍历找到所有"狗狗"，修改为"宠物犬" for (int i = 0; i < petTypeList.size(); i++) { if ("狗狗".equals(petTypeList.get(i))) { // 避免空指针，常量放前面 petTypeList.set(i, "宠物犬"); } } System.out.println("修改后：" + petTypeList); // [宠物犬, 猫咪, 宠物犬, 异宠] } }
2. Iterator 迭代器（安全遍历修改）
迭代器是 Java 官方推荐的集合遍历方式，支持遍历中安全修改元素（需通过Iterator.set()方法，而非 List 的set()）。
java运行
import java.util.ArrayList; import java.util.Iterator; import java.util.List; public class ModifyListByIterator { public static void main(String[] args) { List<Integer> petAgeList = new ArrayList<>(); petAgeList.add(1); petAgeList.add(3); petAgeList.add(2); petAgeList.add(3); System.out.println("修改前：" + petAgeList); // [1, 3, 2, 3] // 迭代器遍历，将所有值为3的年龄改为4 Iterator<Integer> iterator = petAgeList.iterator(); while (iterator.hasNext()) { Integer age = iterator.next(); if (age == 3) { iterator.set(4); // 迭代器的set方法修改当前元素 } } System.out.println("修改后：" + petAgeList); // [1, 4, 2, 4] } }
3. Stream 流（Java 8+，简洁批量修改）
Stream 流适合复杂条件的批量修改，特点是不修改原列表，返回新列表，符合函数式编程风格。
java运行
import java.util.ArrayList; import java.util.List; import java.util.stream.Collectors; public class ModifyListByStream { public static void main(String[] args) { List<String> petFoodList = new ArrayList<>(); petFoodList.add("狗粮"); petFoodList.add("猫粮"); petFoodList.add("鼠粮"); System.out.println("原列表：" + petFoodList); // [狗粮, 猫粮, 鼠粮] // 批量修改：所有元素添加"（通用型）"后缀 List<String> newFoodList = petFoodList.stream() .map(food -> food + "（通用型）") .collect(Collectors.toList()); System.out.println("新列表：" + newFoodList); // [狗粮（通用型）, 猫粮（通用型）, 鼠粮（通用型）] // 条件修改：仅修改"猫粮"为"幼猫猫粮" List<String> conditionList = petFoodList.stream() .map(food -> "猫粮".equals(food) ? "幼猫猫粮" : food) .collect(Collectors.toList()); System.out.println("条件修改后：" + conditionList); // [狗粮, 幼猫猫粮, 鼠粮] } }
四、特殊场景：修改自定义对象的属性
实际开发中，List 常存储自定义对象（如 Pet、User），此时无需替换整个对象，只需修改对象的属性即可（对象在 List 中存储的是引用）。
1. 完整示例
java运行
import java.util.ArrayList; import java.util.List; // 自定义宠物类 class Pet { private String name; // 宠物名称 private int age; // 宠物年龄 private String type; // 宠物类型 // 构造方法 public Pet(String name, int age, String type) { this.name = name; this.age = age; this.type = type; } // getter/setter（修改属性必须提供setter方法） public String getName() { return name; } public void setName(String name) { this.name = name; } public int getAge() { return age; } public void setAge(int age) { this.age = age; } public String getType() { return type; } public void setType(String type) { this.type = type; } // 重写toString，方便打印列表 @Override public String toString() { return "Pet{name='" + name + "', age=" + age + ", type='" + type + "'}"; } } public class ModifyCustomObjectList { public static void main(String[] args) { // 1. 初始化自定义对象列表 List<Pet> petList = new ArrayList<>(); petList.add(new Pet("旺财", 2, "金毛")); petList.add(new Pet("咪咪", 1, "布偶猫")); petList.add(new Pet("团子", 0, "仓鼠")); System.out.println("修改前："); petList.forEach(System.out::println); // 2. 遍历修改对象属性：找到名称为"咪咪"的宠物，修改年龄和类型 for (Pet pet : petList) { if ("咪咪".equals(pet.getName())) { pet.setAge(2); // 修改年龄 pet.setType("英短猫"); // 修改类型 break; // 只修改第一个匹配项 } } System.out.println("\n修改后："); petList.forEach(System.out::println); } }
2. 输出结果
plaintext
修改前： Pet{name='旺财', age=2, type='金毛'} Pet{name='咪咪', age=1, type='布偶猫'} Pet{name='团子', age=0, type='仓鼠'} 修改后： Pet{name='旺财', age=2, type='金毛'} Pet{name='咪咪', age=2, type='英短猫'} Pet{name='团子', age=0, type='仓鼠'}
五、常见错误与避坑指南
- 增强 for 循环直接修改元素：增强 for 循环（for-each）遍历的是临时变量，直接赋值无法修改原列表（仅字符串 / 基本类型会踩坑，自定义对象修改属性不受影响）：java运行
// 错误示例：修改临时变量，原列表无变化 for (String pet : petNameList) { if (pet.equals("仓鼠")) { pet = "金丝熊"; // 仅修改临时变量，列表不变 } }
- 修改不可变 List：
List.of()/Collections.unmodifiableList()创建的列表调用set()会抛异常，需先转为可变 List：java运行
List<String> unmodifiableList = List.of("金毛", "布偶猫"); List<String> modifiableList = new ArrayList<>(unmodifiableList); // 转为可变列表 modifiableList.set(1, "英短猫"); // 正常修改
- 空指针异常：匹配元素时，需先判断元素不为 null，避免
pet.equals("咪咪")中 pet 为 null 导致空指针，推荐写法："咪咪".equals(pet.getName())。
六、最佳实践总结
表格
| 修改场景 | 推荐方式 | 优点 | 适用 Java 版本 |
| 已知索引 | list.set(index, value) |
效率最高（O (1)） | 所有版本 |
| 未知索引，修改单个 / 多个 | 普通 for 循环 | 通用、可控制修改范围 | 所有版本 |
| 遍历中安全修改 | Iterator 迭代器 | 避免并发修改异常 | 所有版本 |
| 批量条件修改（不修改原列表） | Stream 流 | 代码简洁、函数式编程 | Java 8+ |
| 自定义对象属性修改 | 遍历对象 + setter 方法 | 无需替换整个对象，高效 | 所有版本 |
总结
Java 修改 List 元素的核心逻辑是：索引定位（set 方法） 或 内容匹配（遍历 + set），自定义对象则直接修改属性。实际开发中需根据是否已知索引、是否需要批量修改、Java 版本选择合适方式，同时注意避免索引越界、空指针、修改不可变列表等常见错误。掌握这些方法，能高效处理各类 List 元素修改场景。
