z-index失效主因是父级创建层叠上下文或元素未定位;需检查position非static、排查opacity/transform/filter等触发条件,并确认Tailwind配置格式正确且已重启服务。

z-index 失效,90% 不是数值设小了,而是元素被关进了某个父级创建的层叠上下文里 —— 它只在那个“小房间”里比高低,对外面完全没影响。
检查目标元素是否已定位
z-index 对 position: static(默认值)完全无效,浏览器直接忽略该声明。这不是“效果弱”,是压根不读。
- 打开 Chrome DevTools,选中元素,在 «Computed» 面板搜
position,确认最终值不是static - 临时加一行
position: relative,再看z-index是否立刻生效(relative最安全,不破坏文档流) - JS 动态插入元素时,必须同步设置
style.position和style.zIndex,漏掉前者等于白写 - 别指望
display: flex或grid容器让子项自动获得定位能力 —— 子项自己得显式声明position
排查父级是否意外创建了层叠上下文
只要某个祖先元素满足以下任一条件,它就创建了独立的层叠上下文,把所有子元素“锁”在里面:
-
opacity小于 1(哪怕opacity: 0.999) -
transform不为none(包括translateZ(0)、scale(1)这类看似无害的写法) -
filter不为none(哪怕blur(0)) -
will-change: transform或will-change: opacity isolation: isolate-
position: fixed或sticky且z-index不是auto
调试方法:在 DevTools 中逐级点击父节点,右侧面板 «Layout» 标签页留意 «Stacking context» 是否突然变成 Yes;临时注释掉可疑属性,看遮挡是否消失。
响应式断点中 z-index 突然失效?重点查媒体查询激活的 transform / opacity
很多响应式动画会加 transform: translateZ(0) 强制 GPU 加速,但只要它在某个断点里被激活,父容器立刻变成层叠上下文根节点。
- 切到对应断点,在 «Computed» 面板搜
transform,看是否从none变成了具体值 - iOS Safari 对
translateZ(0)更敏感,移动端要优先排查 - flex/grid 容器在断点中启用后,若父级同时有
opacity: 0.99,整个子项组就被隔离 —— 别依赖 “flex 子项自动有层级” - 所有涉及
position变更的媒体查询(如 desktopstatic→ mobilefixed),必须成对修改:position+z-index
Tailwind CSS 中 zIndex 配置不生效?格式和热重载是关键
Tailwind v3.0+ 已废弃数组写法,zIndex 必须完整定义在 theme.zIndex 下,且键名必须加引号、值必须是字符串。错一个字符,CSS 规则根本不会生成。
- 错误写法:
extend: { zIndex: { 'modal': '50' } }——theme.zIndex默认为空,追加无效 - 错误写法:
modal: 50(数字)或modal(未加引号),JS 解析失败或截断 - 改完配置后没重启开发服务器 —— Tailwind 不热重载配置变更
- ✅ 正确示例:
module.exports = { theme: { zIndex: { 'background': '0', 'dropdown': '1000', 'modal': '2000', 'popover': '3000' } } }
真正难的不是算清哪个值该写多少,而是每次改完样式,都要往上多看两层 DOM,确认那个刚被激活的 transform 或 opacity 没把你需要突出的元素关进盒子。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











