在 Java 编程里，ArrayList 是最常用的动态数组实现。当我们需要确认一个对象是否已经被放进集合时，不需要自己写循环遍历，直接调用 ArrayList 的 contains 方法就能得到布尔结果。理解它的行为和限制，能少写很多 bug。
contains 方法的基本用法
ArrayList 的 contains 方法接收一个 Object 参数，如果集合中存在与该参数 equals 相等的元素，就返回 true，否则返回 false。下面是最简单的字符串示例：
import java.util.ArrayList;
public class Demo {
public static void main(String[] args) {
ArrayList<String> list = new ArrayList<>();
list.add("apple");
list.add("banana");
// 检查是否包含指定对象
boolean hasApple = list.contains("apple");
boolean hasPear = list.contains("pear");
System.out.println(hasApple); // true
System.out.println(hasPear); // false
}
}
底层比较原理
contains 内部会调用 indexOf 方法，而 indexOf 会遍历数组，用每个元素的 equals 方法来和目标对象比较。对于 String、Integer 这些 JDK 自带的类，equals 已经正确重写，所以可以直接用。如果是自己写的类，就要注意 equals 的行为。
自定义类未重写 equals 的问题
如果自定义类没有重写 equals，就会使用 Object 类的默认实现，也就是比较引用地址。这样即使两个对象内容一样，contains 也会认为不存在。
import java.util.ArrayList;
class User {
private int id;
public User(int id) { this.id = id; }
}
public class Test {
public static void main(String[] args) {
ArrayList<User> users = new ArrayList<>();
users.add(new User(1));
// 新对象内容相同但引用不同，默认 equals 返回 false
boolean exists = users.contains(new User(1));
System.out.println(exists); // false
}
}
重写 equals 后的正确写法
在自定义类中重写 equals，根据业务字段判断相等性，contains 就能按预期工作。
import java.util.ArrayList;
import java.util.Objects;
class User {
private int id;
public User(int id) { this.id = id; }
@Override
public boolean equals(Object o) {
if (this == o) return true;
if (o == null || getClass() != o.getClass()) return false;
User user = (User) o;
return id == user.id;
}
@Override
public int hashCode() { return Objects.hash(id); }
}
public class Test {
public static void main(String[] args) {
ArrayList<User> users = new ArrayList<>();
users.add(new User(1));
boolean exists = users.contains(new User(1));
System.out.println(exists); // true
}
}
使用建议
- 对 JDK 常见类型，直接调用 contains 即可。
- 自定义对象务必重写 equals，最好同时重写 hashCode。
- 若集合很大且频繁查重，可考虑用 HashSet 提升性能。
注意：contains 只能判断相等，不能告诉你元素在哪个位置，需要位置时用 indexOf。
掌握 ArrayList.contains 的配合 equals 机制，就能在 Java 中可靠地检查集合是否已存在指定对象。