z-index不生效主因是元素未定位或父容器创建了新层叠上下文;需确保position为relative/absolute/fixed/sticky,且避免opacity
直接给元素加 z-index 却没效果,大概率是因为它只对「定位元素」起作用。也就是说,position 值必须是 relative、absolute、fixed 或 sticky —— static(默认值)下 z-index 完全被忽略。
另一个高频陷阱:父容器建立了新的层叠上下文(stacking context),子元素的 z-index 会受限于该上下文,无法和外部兄弟元素直接比高低。触发新层叠上下文的属性包括:opacity 小于 1、transform 非 none、filter、will-change、isolation: isolate,当然还有 z-index 本身(当父元素 position 为非 static 且 z-index 有具体数值时)。
打开浏览器开发者工具(F12),选中目标元素,在「Computed」面板里搜索 z-index,看它的实际计算值;再往上逐级查看父节点的 stacking context 状态(Chrome DevTools 在 Elements → Styles 右侧的 «La

更直观的方法是临时移除可疑父元素的以下样式,观察层级是否恢复正常:
opacity: 0.99transform: translateZ(0)filter: blur(1px)z-index: 10(且该父元素本身已定位)不需要盲目堆高数字。只要保证同层叠上下文内的兄弟元素之间有明确大小关系即可。比如两个同级弹窗,一个用 z-index: 100,另一个用 z-index: 101 就足够。
但要注意全局协调:建议提前约定层级范围,例如:
z-index: 1–10
z-index: 100–199
z-index: 1000–1099
z-index: 2000+
避免出现 z-index: 9999999 这类写法——它掩盖了结构问题,还可能和第三方库冲突(比如某些 UI 框架 Modal 默认用 z-index: 1050)。
典型场景:一个固定定位的导航栏要始终盖在内容上方,而页面内某个悬浮按钮又想盖在导航栏之上。
.header {
position: fixed;
top: 0;
left: 0;
width: 100%;
z-index: 100; /* 导航栏层级 */
}
.fab-button {
position: fixed;
bottom: 24px;
right: 24px;
z-index: 101; / 必须 > .header 的 z-index,且两者同属根层叠上下文 /
}
关键点:
position: fixed(或同为 absolute 且父容器相同)z-index 的父容器隔离成不同上下文真正难的不是调数字,而是看清 DOM 结构里到底嵌套了几层 stacking context —— 很多时候改一个父元素的 opacity 或删掉一句 transform,整个层级就通了。