Atomics API仅支持SharedArrayBuffer上的整数/浮点数原子操作，无法替代锁或消息机制处理复杂状态同步；必须用相同视图类型访问共享内存，且需确保跨域隔离启用。
Atomics API 能解决 Web Worker 里的简单共享内存竞争，但仅限于 SharedArrayBuffer 上的整数/浮点数原子操作；它不能替代锁或消息机制来处理复杂状态同步。
SharedArrayBuffer 是 Atomics 的前提条件
Atomics 操作的对象必须是 SharedArrayBuffer 背后的 Int32Array、Float64Array 等视图。普通数组（包括 ArrayBuffer）不支持原子操作，直接传入会报 TypeError: expected a shared array buffer view。
常见错误现象：
- 误用
new ArrayBuffer()创建缓冲区 →Atomics.add()报错 - Worker 内未显式传递
SharedArrayBuffer引用，只传普通数组 → 数据不共享，更谈不上原子性 - 主线程和 Worker 对同一
SharedArrayBuffer使用不同长度的视图（如主线程用Int32Array，Worker 用Uint8Array）→ 内存重叠读写，结果不可预测
正确做法：
- 主线程创建
const sab = new SharedArrayBuffer(1024) - 用相同构造方式生成视图：
const ia = new Int32Array(sab)，再将sab通过postMessage(sab, [sab])传输给 Worker - Worker 中接收：
self.onmessage = ({data, ports}) => { const ia = new Int32Array(ports[0]); }
Atomics.add() 和 Atomics.compareExchange() 的适用边界
Atomics.add() 适合计数器类场景，比如统计某类事件发生次数；Atomics.compareExchange() 可模拟“检查-设置”逻辑，但仅限单个整数位的 CAS（Compare-And-Swap），无法安全更新多个字段组成的结构体。
使用场景限制：
- 只能用于
Int8Array/Int16Array/Int32Array/Uint8Array/Uint16Array/Uint32Array/Float32Array/Float64Array - 不支持字符串、对象、布尔值等任意类型；想存 flag？只能映射为 0/1 整数
- 所有操作都要求内存地址对齐（例如
Int32Array必须从 4 字节边界开始）
示例（安全递增计数器）：
const sab = new SharedArrayBuffer(4); const counter = new Int32Array(sab); // 主线程 Atomics.add(counter, 0, 1); // 原子加 1，返回旧值 // Worker 中同样调用 Atomics.add(counter, 0, 1);
注意：Atomics.add(counter, 0, 1) 的第二个参数是索引（不是值），别写成 Atomics.add(counter, 1, 1) —— 那是在改第 2 个元素。
Atomics.wait() / Atomics.notify() 不等于 condition variable
Atomics.wait() 会让当前 Worker 线程挂起，直到另一线程在相同位置调用 Atomics.notify()，但它依赖底层操作系统线程调度，且有严格前置条件：等待前必须确保该位置当前值等于预期值，否则立即返回 "not-equal"。
容易踩的坑：
- 在非
Int32Array视图上调用 → 报错 - 等待时传入的 value 与当前值不一致 → 不阻塞，直接返回，容易漏掉唤醒信号
- 主线程不能调用
Atomics.wait()（浏览器禁止阻塞主线程），只能在 Worker 内使用 - 没有超时参数（
Atomics.wait()第四个参数是 timeout in ms，但部分旧版 Chrome 不支持）
典型误用：
// ❌ 错误：没检查当前值就 wait，可能永远等不到
Atomics.wait(counter, 0, 0);
// ✅ 正确：先确认值为 0，再等它变
if (Atomics.load(counter, 0) === 0) {
Atomics.wait(counter, 0, 0, 1000); // 最多等 1s
}
复杂状态同步仍需消息 + 外部协调
Atomics 解决不了对象字段组合更新、跨字段约束（如“余额 ≥ 扣款金额”）、或需要执行副作用（如触发 DOM 更新、发网络请求）的场景。这时候强行用多个 Atomics 操作拼凑，反而更容易出竞态。
真实项目中更可行的做法：
- 把状态变更封装成纯数据指令（如
{type: "UPDATE_BALANCE", delta: -100}），通过postMessage()发给主线程统一处理 - Worker 内部用
Atomics做轻量标记（如isProcessing = 1），避免重复启动任务 - 需要等待结果时，不用
Atomics.wait()，改用Promise+onmessage回调
最常被忽略的一点：SharedArrayBuffer 在跨域 iframe 或某些隐私模式下默认禁用，需检查 self.crossOriginIsolated 是否为 true，否则 SharedArrayBuffer 构造失败，后续所有 Atomics 调用都会失效。
