arraydeque 明令禁止存 null，因底层循环数组依赖 head == tail 判空，若允许 null 将无法区分空队列与含 null 后弹出的状态，且所有插入方法均强制检查并抛出 nullpointerexception。
ArrayDeque 不是“不推荐”存 null，而是明令禁止——任何插入操作（add、offer、push、addFirst、addLast）传入 null，都会立即抛出 NullPointerException。这不是设计疏忽或风格偏好，而是由其底层循环数组结构决定的硬性约束。
判空逻辑依赖 head == tail
ArrayDeque 用两个索引 head 和 tail 管理一块动态数组，靠 head == tail 判断队列是否为空。这个简洁设计带来高效 O(1) 操作，但也带来一个根本限制：
- 若允许
null，就无法区分“队列当前为空”和“队列曾存过null、弹出后恰好回到 head == tail 状态” - 没有额外位标记某个槽位是“真实 null”还是“未使用”，也无法靠数组元素值反推状态
- 一旦放开 null，所有核心逻辑——扩容判断、
size()计算、遍历、remove查找——都得重写边界条件，牺牲性能与可维护性
源码中每处插入都有显式检查
翻开 JDK 源码，所有插入方法开头都是同一行防御逻辑：
Java JDK 25
下载
Java JDK 25 来自 OpenJDK 官方归档，版本为 JDK 25，本条下载地址已指向官方 Windows x64 zip 安装包直链，适合调试旧项目或兼容旧版 Java 运行环境。
-
addFirst(E e)：直接if (e == null) throw new NullPointerException(); -
addLast(E e)、push(E e)、offerFirst(E e)等全部一致 - 就连看似“失败返回 false”的
offer系列方法，也先检查 null 再判断容量，null 仍会触发异常，而非返回 false
与 LinkedList 的本质差异
LinkedList 基于节点对象，每个元素天然包裹在 Node 实例中，null 只是 Node.data 的值，不影响链表结构判断；而 ArrayDeque 的紧凑数组模型要求每个位置语义明确——要么是有效元素，要么是空闲槽位。这种物理布局决定了它必须放弃对 null 的容忍。
替代方案要语义清晰
业务中真需要表达“缺失”或“未初始化”，不应绕过约束硬塞 null，而应让意图显式化：
- 用
Optional<t></t>包装，插入Optional.empty() - 定义静态哨兵值，如
private static final String MISSING = "MISSING"; - 对接遗留 API 时，在入队前做转换：
queue.offer(str != null ? str : MISSING);
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
