z-index不生效？问题可能不在数值，而在“层叠上下文”
为元素设置了z-index却看不到效果？先别急着将数值调至9999。很多时候，问题的根源并非数值大小，而是元素根本没有进入有效的“层叠上下文”体系。简而言之，z-index属性仅对定位元素（即position属性值为relative、absolute、fixed或sticky的元素）产生作用，并且其层叠比较的范围，被严格限制在同一个层叠上下文内部。
z-index 失效的常见原因分析
直接为元素添加 z-index 却未生效，大概率不是数值错误，而是该元素未处于有效的「层叠上下文」中。CSS 规范规定，z-index 仅对定位元素生效，且其比较层级的功能只在同一层叠上下文内有效。
- 父容器形成“隔离层”：若父级元素未创建新的层叠上下文（例如未设置
transform、opacity、filter等触发属性），则子元素的z-index只能与同级的兄弟元素进行比较。若想跨越父级去覆盖其他区域的元素，是无法实现的。 - 定位方式不正确：
position: static是元素的默认定位方式，它会完全忽略z-index属性。这意味着，即使你设置了z-index: 999999，对于一个static定位的元素而言，该设置等同于无效。 - 文档流的“后来居上”原则：在多个同级元素中，后出现在HTML文档流中的元素，默认会覆盖先出现的元素。这种情况下，即使不设置
z-index也可能看似没有重叠问题，但这种依赖文档顺序的层叠关系非常脆弱且不可控。
如何正确创建可控的层叠上下文
想要让 z-index 按照预期工作，关键在于确保目标元素及其父容器处于一个你可控的层叠层级体系内。最可靠的方法是主动创建层叠上下文，而非依赖浏览器的默认行为。
- 推荐轻量级方案：为父容器设置
position: relative并赋予一个明确的z-index值（例如z-index: 0）。这是兼容性最佳、副作用最小的标准做法。 - 慎用特殊触发属性：虽然
opacity: 0.99或transform: translateZ(0)也能触发层叠上下文，但它们可能带来意料之外的副作用，例如导致内容模糊、影响滚动性能或触发硬件加速，使用时需格外谨慎。 - 建立全局分层策略：对于模态框、下拉菜单、通知提示等需要全局置顶的UI组件，建议在项目中建立统一的
z-index基准线（例如以1000为起点），并在此基础上进行功能分层。例如，遮罩层设为1010，弹窗内容设为1020，下拉菜单设为1030，这样层级关系清晰，易于管理和维护。
z-index 数值设置的安全范围与最佳实践
避免盲目使用 9999 或 999999 这类极大数值。这不仅会导致代码难以维护，还可能被第三方UI库（如Ant Design、Element UI、Vant等）内置的更高层级值覆盖。关键在于建立一个逻辑清晰、可扩展的层级管理体系。
- 基础布局层：导航栏、固定侧边栏、页脚等 → 建议
z-index: 10 - 100 - 浮动提示层：Tooltip（工具提示）、Popover（弹出框）、Dropdown（下拉菜单） → 建议
z-index: 200 - 300 - 交互模态层：Modal（模态对话框）、Drawer（侧边抽屉）、Dialog（对话框） → 建议
z-index: 400 - 500 - 全局覆盖层：全屏Loading遮罩、全局消息通知、权限拦截层 → 建议
z-index: 600 - 1000 - 预留扩展空间：所有层级数值建议以10或100为间隔，例如10、20、30…或100、200、300…，这样可以在需要时轻松插入中间层级，便于调试和功能扩展。
调试元素重叠问题的实战步骤
遇到元素重叠或覆盖异常时，第一步不应该是直接修改z-index数值。正确的排查流程是，像侦探一样系统地检查整个渲染树的结构是否符合预期。
立即学习“前端免费学习笔记（深入）”；
- 第一步：检查计算样式：打开浏览器开发者工具（F12），选中重叠的元素，在右侧“Computed”（计算样式）面板中，确认
z-index属性是否被计算为一个具体的数值，而不是auto。 - 第二步：追溯层叠上下文祖先链：沿着DOM树向上逐级检查每个祖先元素，查看其
position、transform、opacity、filter、isolation等属性，定位到第一个创建了层叠上下文的元素（即第一个z-index值非auto，或拥有其他触发属性的元素）。 - 第三步：可视化元素边界：如果怀疑某个父容器是问题的根源，可以临时为其添加
outline: 2px dashed red;或box-shadow: 0 0 0 2px blue;样式，使其边界和占据的空间一目了然。 - 第四步：理解嵌套比较规则：牢记核心规则：如果两个元素分属于不同的层叠上下文，那么比较的是它们各自上下文根元素的
z-index值。子元素内部的z-index值再大，也无法突破这个“结界”去覆盖另一个上下文中的元素。
总而言之，CSS的层叠与定位逻辑并非简单的“数值大者在上”，而是一个基于层叠上下文的嵌套树状结构。最常见的误区，往往是给一个未定位的元素设置z-index，或者因父容器无意中设置了某些属性（如opacity小于1）而创建了新的层叠上下文，导致子元素的层级比较范围被限制。透彻理解层叠上下文机制，是精准控制页面元素层级、解决CSS重叠问题的关键。
