VSCode悬浮提示异常的根源在于语言服务器、扩展冲突或缓存损坏，而非单纯设置开关；需三步彻底重置：修正settings.json中hover配置、重命名User目录、关闭Settings Sync并清理LSP缓存。
VSCode 悬浮提示（即 hover 提示）不显示、内容错乱、卡顿或根本不出，通常不是单独的“hover 设置”坏了，而是底层配置、扩展冲突或缓存状态异常导致的——editor.hover.enabled 只是开关，真问题往往藏在别处。
为什么清空 settings.json 后 hover 还不恢复？
因为 hover 行为依赖多个环节：语言服务器响应、插件注入的 hover provider、编辑器渲染策略，甚至 UI 缓存。单纯删掉 "editor.hover.enabled": false 或清空 settings.json 并不能解决以下典型问题：
-
settings.json里写了非法值，比如"editor.hover.delay": "500"（字符串而非数字），VSCode 静默忽略整条配置，但 hover 延迟可能因此退回到 0ms，造成闪退式提示 - 已卸载的插件（如旧版
vscode-eslint）仍在settings.json中留有"eslint.enable": true，导致语言服务器初始化失败，连带 hover 失效 - UI 状态缓存文件
storage.json损坏，使 hover 面板无法正确挂载 DOM 节点，表现为“鼠标悬停无反应”，但 Ctrl+Space 补全正常
快速验证是否是插件干扰 hover
不用卸载任何东西，直接用隔离模式启动：
- Windows/Linux：
code --disable-extensions --user-data-dir=/tmp/vscode-hover-test - macOS：
code --disable-extensions --user-data-dir=/tmp/vscode-hover-test - 如果此时 hover 正常，说明是某个扩展在劫持或阻塞 hover provider；逐个启用扩展排查，重点关注 LSP 类插件（如
rust-analyzer、pylsp、intelephense） - 注意：某些插件（如
markdown-preview-enhanced）会在 Markdown 文件中覆盖 hover 行为，但不影响其他语言——要确认你测试的是对应语言文件
彻底重置 hover 相关状态的三步操作
这不是改一个 setting 就能搞定的事，必须清理三层：
- 第一步：确保
editor.hover.enabled是布尔值且为true。打开命令面板（Ctrl+Shift+P），执行Preferences: Open Settings (JSON)，检查并修正该字段，不要留字符串或注释行 - 第二步：重命名整个
User目录（不是只删settings.json）。路径如下：
— Windows：%APPDATA%\Code\User
— macOS：~/Library/Application Support/Code/User
— Linux：~/.config/Code/User
重命名为User_backup，重启 VSCode，它会生成全新干净的User目录 - 第三步：关掉 Settings Sync。左下角齿轮 →
Settings Sync: Turn Off→ 选Turn Off and Reset Local State。否则重命名User后，几秒内所有旧配置（含损坏的 hover 相关扩展设置）会从云端自动拉回
真正容易被忽略的是：hover 提示的底层依赖语言服务器（LSP）进程，而 LSP 的状态缓存在 extensions/xxx/storage 和 Code/Cache 里。重命名 User 目录只清了用户配置，没动这些二进制缓存——所以如果你刚升级过 Python 或 TypeScript 插件，hover 仍异常，就得手动删 %APPDATA%\Code\Cache（Windows）或 ~/Library/Caches/com.microsoft.VSCode.ShipIt（macOS）。
