addFirst 和 offerFirst 功能相同但语义不同：前者是列表结构修改操作，返回 void；后者是队列入队协议，返回 boolean 以支持有界队列契约，体现面向接口编程的设计思想。
addFirst 和 offerFirst 都是把元素插到 LinkedList 开头，但语义定位不同：前者是「列表操作」，后者是「队列操作」。
接口归属决定语义角色
addFirst 属于 Deque 接口的「双端队列行为」，但更常被当作 List 的头插工具使用；offerFirst 则明确属于 Queue/Deque 的「入队协议」——它强调“尝试插入”，哪怕实际不会失败（LinkedList 无容量限制）。
- addFirst 声明在 Deque 中，但设计意图偏向结构修改：不关心是否成功，只执行插入
- offerFirst 是 Queue 接口定义的方法，语义是“尽最大努力加入队首”，返回 boolean 表示逻辑结果（即使总是 true）
- 这种区分让代码意图更清晰：用 addFirst 表示“我要改结构”，用 offerFirst 表示“我要入队”
返回值体现设计契约
addFirst 返回 void，说明调用者无需处理结果；offerFirst 返回 boolean，是为兼容有界队列（如 ArrayBlockingDeque）预留的契约——它承诺“可能失败”，所以必须提供反馈通道。
- LinkedList 中 offerFirst 总返回 true，但调用方仍应按 contract 处理 false 情况
- 若将来把 LinkedList 换成有界实现，仅用 offerFirst 的代码无需修改；而依赖 addFirst 的代码无法自动适配失败场景
- 这是 API 设计中「面向接口编程」的典型体现：行为一致，语义分层
与 push 的关系进一步印证语义差异
push 方法也插队首，但它来自 Stack 语义（LIFO），和 addFirst 同属 void 返回、无失败反馈；而 offerFirst 与 pollFirst / peekFirst 构成完整队列操作三件套，强调非阻塞、可判断的协作模型。
立即学习“Java免费学习笔记（深入）”；
- push ≡ addFirst（栈视角）
- offerFirst + pollFirst ≡ 入队 + 出队（队列视角）
- 混用 push 和 pollFirst 会破坏语义一致性，容易引发维护困惑
本质上，它们底层都调用 linkFirst，区别不在功能，而在你告诉别人“你想干什么”。
