z-index仅对定位元素有效且受限于层叠上下文。需确保position属性正确设置，避免隐式创建新层叠上下文，按功能划分z-index区间并用CSS变量统一管理。

页面层级混乱，本质是元素堆叠顺序没理清。z-index 只对“定位元素”（position 值为 relative、absolute、fixed 或 sticky）生效，非定位元素即使设了 z-index 也无效——这是最常见的误操作起点。

确认元素是否真正参与层叠上下文

z-index 不是全局排序器，它只在**同一个层叠上下文**内起作用。父元素一旦设置了 position + z-index（或 opacity、transform 等触发新层叠上下文的属性），就会创建独立的层叠环境，子元素的 z-index 只在这个小环境里比较，不会跑到父级外面去“抢位置”。

• 检查父容器是否意外加了 transform: translateZ(0)、opacity: 0.99 或 filter —— 这些都会隐式创建新层叠上下文
• 用浏览器开发者工具的“Layers”面板（Chrome）或“Computed”中查看 “layer” 和 “stacking context” 信息
• 若需跨容器控制层级，优先提升共同祖先的 z-index，而非硬调子元素

避免 z-index 魔数，建立清晰层级体系

随手写 z-index: 9999 或 999999 不仅难维护，还容易在后续扩展时撞车。建议按功能划分层级区间：

• 基础层（0–9）：默认内容、卡片、表单控件
• 浮层层（10–99）：下拉菜单、提示气泡、模态框遮罩（如 z-index: 50）
• 强弹窗层（100–199）：全屏模态框、Toast 通知（如 z-index: 120）
• 调试/覆盖层（1000+）：仅限临时调试或特殊覆盖（慎用）

配合 CSS 自定义属性统一管理更稳妥：:root { --z-modal: 120; --z-toast: 130; }，然后写 .modal { z-index: var(--z-modal); }

定位类型要配对使用

z-index 生效的前提是元素已定位。常见错误包括：

• 只写 z-index: 10;，但没加 position: relative; → 完全无效
• 想让按钮浮在图片上，给按钮加 absolute 却忘了给父容器设 relative → 按钮相对视口定位，布局错乱
• 多个 absolute 元素堆叠，但没统一它们的定位参考点（比如都 top: 0 left: 0），导致视觉重叠却无法靠 z-index 区分前后

正确做法：先确定谁当“定位容器”，设 position: relative;；再让子元素用 absolute/fixed 定位，并通过 z-index 控制彼此顺序。

调试技巧：快速定位问题根源

遇到“明明写了 z-index 却不生效”，按这个顺序排查：

• 打开开发者工具，选中目标元素 → 查看 Computed 面板里的 position 是否为预期值（不是 static）
• 看 z-index 是否显示为实际数值（若显示为 auto，说明没生效）
• 点击右上角三个点 → “Show stacking context” → 观察该元素是否被包裹在某个低 z-index 的父层叠上下文中
• 临时加 outline: 2px solid red; 和 background: rgba(255,0,0,0.1); 直观判断渲染顺序