Hover与CodeLens因渲染层级相同但定位逻辑不同而互相遮挡，根本解法是控制内容长度、切换触发时机、释放视口空间，而非调整位置参数。
为什么悬浮提示（Hover）和代码透镜（CodeLens）会互相遮挡
Hover 和 CodeLens 渲染在同一个视觉层级，但定位逻辑完全不同：Hover 始终紧贴光标位置、由编辑器内核硬编码绝对定位；CodeLens 则固定在代码行上方、随文档滚动而浮动。当两者在同一垂直区域（比如函数定义行）同时触发时，Hover 会盖住 CodeLens 的「1 impl」或「2 refs」文字——这不是 bug，而是 VSCode 渲染层未做 Z-index 协调的结果。
常见错误认知是“调大 CodeLens 字体就能顶开 Hover”，实际无效：CodeLens 文字大小受 editor.codeLensFontSize 控制，但它的容器高度不随字体放大而增长，Hover 仍按原坐标覆盖。
- Hover 的 DOM 元素类名通常含
hover-preview，CodeLens 是codelens-decoration，二者无父子关系，无法用 CSSz-index可靠干预 - CodeLens 的垂直偏移量（距代码行顶部的距离）不可配置，
editor.codeLensHeight并不存在 - 某些插件（如 GitLens）会注入自定义 CodeLens，其渲染时机晚于 Hover，更容易被压在底层
真正能缓解遮挡的 settings.json 配置项
没有“让 Hover 往上挪 10px”这种开关，但可通过压缩 Hover 高度、抬高 CodeLens 视觉感知来错开重叠区：
- 缩小 Hover 内容密度：
"editor.hover.delay": 500（延迟弹出，给眼睛留出预判时间），配合"editor.hover.sticky": false（鼠标移开即收起，避免悬停残留） - 控制 Hover 自身高度：
"editor.suggestFontSize": 12和"editor.suggestLineHeight": 20同时生效时，Hover 面板整体变紧凑，减少向下侵占空间 - 强制 CodeLens 显得“更高”：
"editor.codeLensFontSize": 13（仅放大文字，不改变位置，但人眼会下意识把大字当成更靠上的元素） - 禁用非必要 CodeLens 类型，例如关掉 Intelephense 的
intelephense.codeLens.implementations.enable，减少行首文字堆叠
GitLens / Intelephense 等插件的透镜行为差异
不同插件注册 CodeLens 的策略直接影响与 Hover 的冲突频率：
- GitLens 默认在每一行都尝试注入作者/提交信息，导致大量 CodeLens 挤占顶部空间；可改用
"gitlens.codeLens.scopes": ["functions", "classes"]限定只在符号定义处显示 - Intelephense 的
overrides和referencesCodeLens 是异步扫描后插入的，常比 Hover 慢几十毫秒，结果就是 Hover 先弹、CodeLens 后挤进来——此时设置"intelephense.codeLens.enabled": false关全局，再单独开"intelephense.codeLens.parent.enable"更可控 - Fitten Code 的 CodeLens 若与 Hover 冲突，优先检查
"fittenCode.showFullTooltip": true是否启用：开启后 Hover 内容变长，反而加剧遮挡，此时应搭配"editor.hover.maxHeight": 300限制其最大高度（该配置存在且有效）
手动触发 + 空间管理才是稳定解法
依赖自动弹出必然冲突，换成交互节奏由你掌控更可靠：
- 关掉自动 Hover：
"editor.hover.enabled": false，改用Ctrl+K Ctrl+I手动唤出——它强制在编辑器中央展开，完全避开 CodeLens 区域 - 临时隐藏 CodeLens：按
Ctrl+Shift+P→ 输入Toggle Code Lens→ 回车（部分插件支持此命令，GitLens 和 Intelephense 均可用） - 收起终端/侧边栏腾出纵向空间：
Ctrl+`隐藏终端，Ctrl+B隐藏侧边栏，Hover 自动获得更大安全区 - 别忽略工作区配置优先级：若你在项目根目录有
.vscode/settings.json，其中的editor.hover.delay会覆盖用户级设置，确保所有配置写在正确层级
最常被忽略的一点：Hover 和 CodeLens 的共存问题本质是垂直空间竞争，而非位置参数缺失。任何试图“精确定位”的尝试都会失败，真正有效的动作永远围绕「控制内容长度」「切换触发时机」「释放视口空间」这三件事打转。
