Java List 删除整数时怎么区分下标和元素

在 List 里写 list.remove(1)，删掉的不是数值 1，而是下标为 1 的元素。因为编译器会优先匹配 remove(int index)；如果目标是按值删除，应写成 list.remove(Integer.valueOf(1))。这个差异来自两个重载的参数类型不同，不是 ArrayList 的特殊规则。

记忆方法：要删位置就传 int，要删整数元素就显式装箱成 Integer；要删所有符合条件的值则用 removeIf。

先看清 remove 的两个重载

Java SE 21 的 List 接口同时声明了 E remove(int index) 和 boolean remove(Object o)。前者按位置删除，并把被删元素返回；后者按 Objects.equals 找到下标最小的首个匹配项，返回列表是否发生变化。两者都属于可选的修改操作，列表实现可以限制它们。

下图只画 API 的静态关系：同一个 List 有两个入口，int 参数表达位置，Integer 对象表达待匹配的元素，最终返回的信息也不同。

这里的关键不是“数字长什么样”，而是调用点经过重载解析后选择了哪个签名。代码审查时先看参数静态类型，再看删除后的断言。

List 删除元素要显式装箱

下面的例子故意让列表里有重复的 1。第一次调用删除下标 1 的元素；第二次用 Integer.valueOf(1) 删除第一个值为 1 的元素。因为按值删除只移除首个匹配项，剩余的另一个 1 会保留。

import java.util.ArrayList;
import java.util.List;

public class ListRemoveDemo {
    public static void main(String[] args) {
        List numbers = new ArrayList(List.of(10, 1, 20, 1));

        Integer removedByIndex = numbers.remove(1);
        // int 参数表示零基下标，这里删除原来的第 2 个元素。
        System.out.println(removedByIndex + " -> " + numbers);

        boolean removedByValue = numbers.remove(Integer.valueOf(1));
        // 显式装箱后匹配元素值，只删除第一个 1。
        System.out.println(removedByValue + " -> " + numbers);
    }
}

输出的重点是两次返回值：位置删除拿到被删的 Integer，按值删除拿到 boolean。如果把变量声明为 Integer target = 1，再写 numbers.remove(target)，同样会进入 remove(Object)。

批量按条件删除用 removeIf

如果需求是“删除所有偶数”或“删除所有小于某个阈值的值”，不要在循环里不断根据旧下标调用 remove(int)。元素删除后后续下标会左移，正向遍历很容易跳过数据。removeIf 直接表达保留边界，返回值还能说明列表是否改变。

List scores = new ArrayList(List.of(3, 8, 10, 11, 14));

boolean changed = scores.removeIf(score -> {
    // 谓词只描述删除条件，不在这里修改列表结构。
    return score % 2 == 0;
});

System.out.println(changed); // true
System.out.println(scores);  // [3, 11]

如果列表中没有偶数，changed 就是 false，原列表保持不变。谓词中不要再次对同一个列表做添加或删除；让它只读取当前元素，结果更容易推断。

检查 List 是否真的支持删除

调用写对了仍可能失败，因为列表来源决定修改能力。List.of 创建的是不可修改列表，任何添加、删除或替换都会抛出 UnsupportedOperationException。需要改变长度时，把它复制到 ArrayList：

List source = List.of(10, 20, 30);
List mutable = new ArrayList(source);

// 复制后的 ArrayList 支持结构修改。
boolean changed = mutable.remove(Integer.valueOf(20));
System.out.println(changed + " -> " + mutable);

Arrays.asList 是固定长度的列表视图，通常支持 set，但不支持改变长度的 add、remove 和 removeIf。subList(from, to) 则是原列表的一段视图，视图上的结构修改会作用到原列表；如果只想得到独立副本，同样应显式复制。

遇到异常时，先回到创建列表的地方查清实现，不要把 UnsupportedOperationException 误判成 remove 重载选错。

用返回值和最终列表做验收

删除操作至少核对三件事：参数意图、返回值和删除后的内容。按下标删除前确认 0 ；按值删除若需要知道是否命中就检查 boolean；重复值场景明确是删首个还是删全部。

最后把边界写进测试：空列表和越界位置、没有匹配值、重复值、List.of 来源，以及 subList 修改是否符合预期。这样以后有人把 Integer 改回 int，或更换列表实现时，问题会在断言处暴露。

常见问题

为什么 List 的 remove(1) 不是删除数字 1？

因为字面量 1 可以直接匹配 int，重载解析选择了 remove(int)。用 Integer.valueOf(1) 或 Integer target 才能明确按对象值删除。

按值删除会删除所有重复整数吗？

不会。remove(Object) 只删除首个相等元素；要删全部匹配项，用 removeIf，或先明确构造一个新的过滤结果。

List.of 删除时报 UnsupportedOperationException 怎么办？

它是不可修改列表。若业务确实需要改变长度，使用 new ArrayList(source) 创建可变副本；若只需读取，就不要调用删除。

收尾检查

把规则压缩成一句话：删位置用 remove(int)，删一个整数值用 remove(Integer)，删所有满足条件的值用 removeIf；调用前再确认列表是否支持结构修改。配合返回值和最终列表断言，Java List 删除整数时最常见的错删问题就能稳定复现和修正。