z-index不生效主因是元素未定位或父容器创建了新层叠上下文；需确保position为relative/absolute/fixed/sticky，且避免opacity
z-index 不生效的常见原因
直接给元素加 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 右侧的 «Layout» 标签页里会显示「Stacking context» 提示）。
更直观的方法是临时移除可疑父元素的以下样式，观察层级是否恢复正常：
立即学习“前端免费学习笔记（深入）”；
opacity: 0.99transform: translateZ(0)filter: blur(1px)-
z-index: 10（且该父元素本身已定位）
z-index 数值设多大才安全
不需要盲目堆高数字。只要保证同层叠上下文内的兄弟元素之间有明确大小关系即可。比如两个同级弹窗，一个用 z-index: 100，另一个用 z-index: 101 就足够。
但要注意全局协调：建议提前约定层级范围，例如：
- 基础 UI（如按钮、卡片）：
z-index: 1–10 - 下拉菜单 / Tooltip：
z-index: 100–199 - 模态框（Modal）：
z-index: 1000–1099 - 全屏加载遮罩：
z-index: 2000+
避免出现 z-index: 9999999 这类写法——它掩盖了结构问题，还可能和第三方库冲突（比如某些 UI 框架 Modal 默认用 z-index: 1050）。
用 position + z-index 实现稳定覆盖关系
典型场景：一个固定定位的导航栏要始终盖在内容上方，而页面内某个悬浮按钮又想盖在导航栏之上。
.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的父容器隔离成不同上下文 - 数值差 1 就够，不必跨量级
真正难的不是调数字，而是看清 DOM 结构里到底嵌套了几层 stacking context —— 很多时候改一个父元素的 opacity 或删掉一句 transform，整个层级就通了。
