定位元素残留的本质是DOM节点未被删除，而非z-index未重置；第三方库将节点插入body等非组件根节点后，组件卸载不会自动移除，需在生命周期钩子中主动查询并remove对应节点。

定位元素残留的本质是 DOM 节点没删，不是 z-index 没重置

组件销毁后还看到弹窗、遮罩或浮动层，90% 不是因为样式没清，而是 DOM 元素本身还在 document 上挂着。Vue 的 v-if 或 React 的条件渲染只是卸载组件实例，但第三方库（如 Element UI、Ant Design、ECharts）常在 mounted/useEffect 里手动插入 div 到 body 或其他非组件根节点位置——这些节点不会随组件卸载自动移除。

• 检查浏览器 Elements 面板，搜索 .el-overlay、.ant-modal-root、.chart-container 等类名，确认它们是否脱离组件树存在
• Element UI 的 :append-to-body="true"、Ant Design 的 getPopupContainer、ECharts 的 container 参数，都会导致 DOM “逃逸”
• z-index 冲突只是表象，真正卡住的是那个没被 remove 的 div ——它还在那里，自然就压着别的东西

Vue 中清理挂载到 body 的定位元素：onBeforeUnmount + querySelector

不能只靠 v-if 或 visible.sync，必须主动清理。Element UI 的遮罩残留就是典型例子：它把 .el-overlay 插入 body，但关闭时若组件提前销毁，清理逻辑可能来不及执行。

• 在 onBeforeUnmount（Vue 3）或 beforeDestroy（Vue 2）钩子里，用 document.querySelector 定位并 remove() 对应节点：

  onBeforeUnmount(() => {
    const overlay = document.querySelector('.el-overlay');
    if (overlay) overlay.remove();
    const dialogWrapper = document.querySelector('.el-dialog__wrapper');
    if (dialogWrapper) dialogWrapper.remove();
  });

• 避免用 document.querySelectorAll 批量删——可能误杀其他组件的同类节点；优先加唯一 class 或 data 属性标识，比如 data-dialog-id="user-edit"
• 如果用了 createApp 挂载弹窗（如独立消息提示），记得调用 app.unmount() 并手动删容器节点

React 中防止定位元素残留：useEffect 清理 + AbortController 配合

React 没有内置的“组件级 DOM 清理”，所有手动插入的节点都得自己管。常见错误是只清定时器、不删 DOM；或者清了 DOM，但没同步清掉绑定在它上面的事件监听器。

React Component Auditor

审计 React 组件的性能、可访问性、Hook 正确性、属性设计和重渲染优化——识别 memo 优化点和状态管理方案

下载

• 在 useEffect 里插入节点，返回的清理函数必须做两件事：node.remove() 和 node.removeEventListener()：

  useEffect(() => {
    const overlay = document.createElement('div');
    overlay.className = 'custom-overlay';
    overlay.style.cssText = 'position: fixed; inset: 0; background: rgba(0,0,0,0.5);';
    document.body.appendChild(overlay);
  
    return () => {
      overlay.remove(); // 必须写
    };
  }, []);

• 如果 overlay 里还有子组件（如按钮、动画），确保子组件也实现了自己的清理逻辑；否则容易出现“父节点删了，子节点事件监听器还在”的情况
• 对 fetch 请求等异步操作，即使 DOM 已删，也要用 AbortController 中断请求，避免回调里再操作已删节点：controller.abort() 应该和 node.remove() 在同一清理函数中执行

scoped 样式无法保护定位元素，必须靠 DOM 层级隔离

<style scoped> 或 CSS Modules 只影响组件内生成的 DOM，对插到 body 的弹窗、提示、下拉菜单完全无效。它们的样式仍是全局的，且极易因父容器触发新层叠上下文而失效。

立即学习“前端免费学习笔记（深入）”；

• 不要指望 :deep(.el-overlay) 能控制外部节点样式——它只作用于当前组件模板内的子元素，不生效于 document.body 下的节点
• 真正可控的方式是：给每个动态插入的节点加唯一前缀 class，比如 myapp-user-dialog-overlay，再用独立 CSS 文件管理，避免和第三方库冲突
• 如果必须复用 Element/AntD 组件，优先用 getContainer={() => document.getElementById('app')} 把浮层限制在应用容器内，而不是放飞到 body ——这样组件卸载时，整个容器清空就能一并带走

组件销毁时定位元素残留，最常被忽略的不是“怎么删”，而是“删哪里”。很多人盯着组件内部的 ref 和 state，却忘了查 document.body 里那些静默存活的 div。