根本原因是气泡挂载节点未进入全局层叠上下文或被父容器截断；需定位真实挂载容器（如#atom-overlay）、设position:fixed、清除body的transform/opacity干扰，并用styles.less覆盖，而非盲目调高z-index。
Atom 编辑器的代码气泡（如 tooltip、autocomplete、linter 提示）被遮挡，根本原因不是 Atom 本身“层级低”，而是它挂载的 DOM 节点未正确进入全局层叠上下文，或被父容器截断。直接改 z-index 值往往无效，因为气泡组件通常由第三方插件（如 atom-ide-ui、autocomplete-plus）动态渲染到 body 下，但若 body 或其祖先缺失定位，就会导致 z-index 失效。
为什么改 .tooltip 的 z-index 没用
常见错误是直接在样式表里写：
.tooltip { z-index: 9999 !important; }
这几乎一定失效，原因有三：
-
.tooltip元素本身没设position（比如仍是position: static），z-index完全被忽略 - 气泡实际挂载点（如
#atom-overlay或.autocomplete-popup）才是真父容器，你改的类可能根本没匹配到它 - Atom 启动时会注入内联样式或 shadow DOM，CSS 优先级高，
!important也压不过
找到真实挂载容器并设 position
打开开发者工具 → 悬停触发气泡 → 在 Elements 面板中搜索 tooltip、autocomplete、overlay 等关键词，定位到最外层容器（常见如 .autocomplete-suggestion-list、.linter-ui-default-tooltip、#atom-overlay）。确认它是否已设 position：
- 若没有，必须显式加
position: fixed或position: absolute——fixed更稳妥，避免被滚动容器裁剪 - 若已有
position，检查它的父级（尤其是body）是否触发了新层叠上下文（比如transform: translateZ(0)、opacity: 0.99） - 若
body无position，则所有挂载到body下的浮层都默认以html为层叠根，此时z-index才真正全局有效
用 Atom 主题样式覆盖（推荐）
Atom 支持用户级样式覆盖：~/.atom/styles.less（Linux/macOS）或 %USERPROFILE%\.atom\styles.less（Windows）。在这里写针对性规则：
// 确保挂载容器有定位且层级足够
#atom-overlay,
.autocomplete-suggestion-list,
.linter-ui-default-tooltip {
position: fixed !important;
z-index: 2147483647 !important; // 最大安全整数，避开 overflow 风险
}
// 防止父容器截断（如某些 UI 主题给 body 加了 transform）
body {
transform: none !important;
opacity: 1 !important;
}
注意：2147483647 是 32 位有符号整数上限，比 999999 更可靠，旧版 Electron 渲染器不会溢出。
插件级修复：检查 overlay-manager 行为
部分插件（如 atom-ide-ui）使用自己的 overlay manager，它可能把气泡挂到非 body 的节点下（比如某个 .editor 内部）。这时即使你改了全局样式也没用。解决方法：
- 在插件设置里找 “Overlay Container” 或 “Mount Point” 选项，强制设为
body - 若无此选项，可临时 patch 插件源码：搜
document.body.appendChild或attachTo，确保气泡 append 到document.body - 禁用冲突插件（如某些主题或 UI 增强插件）——它们常偷偷给
body加transform或will-change
真正起作用的从来不是数字堆高，而是让气泡脱离被截断的层叠上下文，并确保它挂载在真正“自由”的容器上。改完记得重启 Atom，CSS 注入时机早于插件初始化，否则样式可能被覆盖。
