CopyOnWriteArraySet通过写时复制机制实现安全遍历:写操作复制底层数组并原子替换,迭代器持有快照,读操作无锁且不抛ConcurrentModificationException。
copyonwritearrayset 是 java 并发包(java.util.concurrent)中一个线程安全的无序集合,底层基于 copyonwritearraylist 实现。它适合读多写少、需安全遍历且容忍短暂数据陈旧性的场景——但不是万能高性能方案,关键在“用对地方”。
为什么 CopyOnWriteArraySet 能安全遍历?
它的核心机制是“写时复制(Copy-On-Write)”:
- 所有修改操作(
add、remove、clear)都会先复制当前底层数组,修改副本,再用原子引用替换原数组; - 迭代器(
iterator())持有创建时刻数组的快照,因此遍历时不会抛ConcurrentModificationException,也不受后续写操作影响; - 读操作(
contains、size、iterator)完全无锁,响应极快。
去重逻辑天然可靠,但要注意语义细节
它继承 Set 接口,自动保证元素唯一性,判断依据是 equals() + hashCode():
- 添加重复元素(满足
equals)会静默忽略,返回false; - 若自定义类未重写
equals和hashCode,默认使用对象地址,可能导致逻辑去重失效; - 注意:
CopyOnWriteArraySet不保证插入顺序,也不排序,如需有序去重,请考虑ConcurrentSkipListSet或加锁控制。
典型适用场景与避坑提醒
它高效的前提是:**读远多于写,且单次写操作数据量不大**:
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式,或要求按照代码注释规范处理 Java 文件时,使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则,并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括:补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- ✅ 适合:监听器注册表、白名单缓存、配置项动态集合(如运行时启用的插件 ID)、日志采集中的临时去重标签;
- ❌ 不适合:高频增删(如每秒数千次写)、大数据集(如百万级元素,每次 add 都复制整个数组开销巨大)、强实时一致性要求(写入后其他线程可能立即读不到最新值);
- ⚠️ 注意:
size()返回的是快照大小,isEmpty()同理;批量操作如addAll仍是一次复制,不比循环add更高效。
简单示例:线程安全的事件监听器管理
避免遍历中注册/注销导致异常的经典问题:
立即学习“Java免费学习笔记(深入)”;
CopyOnWriteArraySet<EventListener> listeners = new CopyOnWriteArraySet<>();
// 安全注册
listeners.add(new ClickHandler());
// 安全遍历通知(即使其他线程同时 add/remove 也不报错)
for (EventListener listener : listeners) {
listener.onEvent(event);
}
// 安全注销
listeners.remove(oldHandler);


















