z-index 不生效的主因是未满足定位条件或层叠上下文限制。要使 z-index 生效，元素必须设置 position 为 relative、absolute、fixed 或 sticky；其次，若子元素所在父容器层级较低，其 z-index 再高也会被压制，需调整父级层级关系；常见问题还包括忘记设定位属性、使用负值或受浏览器默认样式干扰，排查时应依次检查定位状态、父级影响及使用开发者工具分析结构。掌握这些规则可有效控制元素层级。
网页布局中，元素层级的控制很关键，尤其是当多个元素重叠时。想让某个元素显示在最上层或者被压在下面，z-index 是最常用的手段。不过很多人用的时候会遇到 z-index 不生效的问题，其实关键在于理解它的使用条件和层叠规则。
一、z-index 的基本用法
z-index 只对定位元素有效，也就是说，必须给元素设置 position 属性为 relative、absolute、fixed 或 sticky，否则 z-index 是不会起作用的。
举个例子：
立即学习“前端免费学习笔记（深入）”；
.box {
position: absolute;
z-index: 10;
}这样就能确保这个 box 在同级元素中尽可能靠前显示。数值越大，层级越高。但注意，它只在同一“层叠上下文”里比较才有效。
二、层叠上下文的影响
z-index 看起来简单，但真正复杂的是层叠上下文（stacking context）。如果两个元素分别属于不同的父容器，而其中一个父容器本身层级较低，那么即使子元素 z-index 很高，也可能被整体压住。
比如：
<div class="parent1"> <div class="child" style="z-index: 1000">我是子元素</div> </div> <div class="parent2"></div>
如果 parent1 没有定位，或者它的 z-index 比 parent2 小，那 child 再怎么设 z-index 也很难浮出来。这时候需要调整 parent 的层级关系，而不是只看子元素。
三、常见问题与解决方法
最常见的问题是设置了 z-index 却没效果。这往往是因为：
- 忘记加
position属性； - 元素被包裹在另一个层叠上下文中；
- 使用了负值导致被隐藏；
- 浏览器默认样式干扰。
建议排查顺序是：先确认是否定位了，再检查父级是否有影响，最后用浏览器开发者工具查看层级结构。有时候一个简单的 z-index: 9999 能快速解决问题，但不要滥用，避免后续维护困难。
基本上就这些。掌握好 z-index 和层叠上下文的关系，布局时就能更自如地控制元素显示优先级。
