Web Locks API 仅协调逻辑执行时序，不锁 DOM 或资源本身；锁名须 URL-safe 且含业务唯一标识（如 cart-${userId}），禁用固定字符串或时间戳；写操作必须 mode: 'exclusive' 且启用 ifAvailable: true；所有修改逻辑需在回调内完成并返回 Promise，锁自动释放；Safari 不支持，必须降级为服务端幂等+localStorage 冲突提示；锁作用域限同源同用户代理非隐私模式。
Web Locks API 不能直接锁 DOM 或共享资源本身，它只协调“谁能在同一时间执行某段逻辑”——所有读-改-写操作必须包进 navigator.locks.request() 回调里，且返回 Promise；不支持 Safari，降级不是可选，是必须。
锁名必须带业务唯一标识且 URL-safe
锁名就是作用域。用固定字符串如 'cart' 或 'draft'，会导致所有用户、所有资源串行阻塞，性能雪崩。
- ✅ 正确：用
`cart-${userId}`、`note-${docId}`、`config-theme`（全站统一配置才用无 ID） - ❌ 错误：
'cart'（所有购物车抢同一把锁）、`cart-${Date.now()}`（每次锁名不同，完全失效） - 锁名中避免空格、斜杠、控制字符；长度建议 ≤64 字符，过长可能影响内部哈希效率
写操作必须用 mode: 'exclusive' 并启用 ifAvailable: true
不显式设 mode，旧版 Chrome 会静默 fallback 到 shared，而 shared 锁无法阻止并发写入——你以为加了锁，实际毫无保护。
- 写操作只接受
mode: 'exclusive'；读操作才考虑shared - 不传
ifAvailable: true，锁不可用时会无限等待，UI 卡死；高交互场景务必启用 - 可配合
AbortSignal加超时，例如{ ifAvailable: true, signal: AbortSignal.timeout(3000) }
所有修改逻辑必须在回调内完成并返回 Promise
锁在回调函数退出（或 Promise settle）后自动释放。同步返回、没 await、漏掉 tx.done，都会导致锁提前释放，竞态照旧。
立即学习“前端免费学习笔记（深入）”；
- IndexedDB 写操作必须
await tx.done，不能只tx.commit()—— 后者不保证写入落地 - localStorage 是同步 API，但为统一模式，建议封装成 Promise 并
return Promise.resolve() - 不要在锁回调里做耗时操作：上传、加密、大数组遍历、DOM 渲染等，都移出锁外
- UI 更新（如 badge 刷新）、日志、通知等副作用，一律放在锁外
Safari 不支持，降级方案不能跳过逻辑
截至 iOS 17.5 / macOS 14.5，Safari 仍无 Web Locks API 支持痕迹。仅靠 if ('locks' in navigator) 就跳过，等于在 Safari 里裸奔。
- 服务端幂等是底线：每个写请求附带客户端生成的
requestId，后端拒绝重复处理 - 前端轻量 fallback：用
localStorage存时间戳 + 监听storage事件，检测到冲突时 UI 提示“其他窗口正在编辑” - 注意：localStorage 模拟不是强一致，仅作友好提示，不能替代服务端兜底
真正容易被忽略的是锁的**作用域边界**：同源、同用户代理、非隐私模式——跨浏览器、跨设备、隐身窗口之间完全不共享锁管理器。别指望它解决分布式问题，它只管你当前浏览器里那几个标签页和 Worker。
