Element.id赋值前必须确保全局唯一，否则document.getElementById()只返回首个、querySelector()命中全部、锚点跳转错位；应通过时间戳+计数器、crypto.randomUUID()或命名空间前缀生成唯一ID，并在DOM插入前完成赋值。
Element.id 赋值前必须确保值全局唯一
直接给 element.id 赋值不会自动去重或校验，浏览器完全放行重复 ID —— 但后果是 document.getElementById() 只返回第一个、querySelector('#my-id') 会命中所有、锚点跳转只滚到第一个。你得自己兜底。
常见踩坑场景：
- 富文本编辑器（如 TinyMCE、Quill、Slate）插入多个相同类型区块（比如“引用块”），模板里写死
id="quote-block" - 服务端渲染 HTML 片段后，客户端再次用 JS 动态插入同结构内容，ID 没加前缀或时间戳
- 复制粘贴编辑器内容时，原
id被一并带入，没做清洗或重生成
验证是否唯一最简单的方法：console.log(document.querySelectorAll('[id="your-id"]').length)，结果大于 1 就得改。
动态生成唯一 ID 的三种可靠方式
不要用 Math.random() 或纯时间戳字符串（如 new Date() + ''），它们在高并发或快速连续操作下有碰撞风险。优先选以下组合：
立即学习“前端免费学习笔记（深入）”；
-
时间戳 + 计数器：用闭包或模块变量维护递增计数，例如
const id = `editor-block-${Date.now()}-${counter++}` -
crypto.randomUUID()（现代浏览器支持）：直接
element.id = 'block-' + crypto.randomUUID()，无需 polyfill（2026 年已覆盖全部主流环境） -
基于编辑器实例的命名空间前缀：如编辑器挂载在
div#editor-123下，则生成id="editor-123-quote-456"，避免跨实例冲突
不推荐用 new Date().getTime() 单独作为 ID —— 同一毫秒内多次调用会撞车，尤其在批量插入节点时。
编辑器内容插入后，ID 必须立即生效且可被 JS 查找
很多编辑器（尤其是 React/Vue 封装版）会在内容插入后触发异步 DOM 更新，此时直接 element.id = 'xxx' 可能被后续 hydration 或 patch 覆盖。
安全做法：
- 若用
innerHTML插入 HTML 字符串，确保 ID 已拼接进字符串中，而不是插入后再赋值：el.innerHTML += '<blockquote id="blk-' + genId() + '">...</blockquote>' - 若用
document.createElement()，务必在appendChild()前设置id：const b = document.createElement('blockquote'); b.id = genId(); parent.appendChild(b); - 监听编辑器的
change或input回调，在其回调内操作 DOM 节点，而非在事件外直接查getElementById
特别注意：某些编辑器（如 ProseMirror）根本不允许直接操作底层 DOM，得走其 API 插入带 data-id 的节点，再用 CSS 属性选择器定位 —— 此时别硬塞 id，改用 data-editor-id 更稳妥。
为什么不能依赖编辑器自动生成的 ID？
多数编辑器默认不生成 ID，或仅在内部使用（如 Slate 的 key、ProseMirror 的 node.attrs.id），这些值不保证输出到 HTML、不参与锚点跳转、也不被 getElementById() 识别。
即使编辑器声称“支持 ID”，也要确认三点：
- 该 ID 是否真实写入最终渲染的 HTML 元素的
id属性（而非仅存在 JS 对象里） - 该 ID 是否在每次内容变更后保持稳定（比如拖拽排序后 ID 是否重排）
- 该 ID 是否全局唯一（特别是多编辑器实例共存时）
实践中，90% 的 ID 相关 bug 都源于信了文档里一句“ID will be auto-generated”，结果发现它只在内存里有效。
