VSCode默认开启鼠标悬停提示,无内容主因是LSP未就绪或光标位置错误:需检查光标是否紧贴标识符、右下角语言模式是否正确、TS/JS项目有tsconfig.json/jsconfig.json、Python装了Pylance、大项目等待LSP索引完成。

VSCode 默认就开启鼠标悬浮文档提示,关掉才是异常状态;绝大多数“没反应”不是因为没开,而是语言服务器(LSP)压根没加载成功或光标停错了位置。
为什么悬停没内容?先看这五个常见卡点
悬停弹出空白、只显示 no definition found 或仅有基础类型(如 string),基本可排除设置问题,直接检查以下几点:
- 光标是否紧贴在标识符字母上?停在
fetch后面的空格、括号内、分号后、注释里或字符串中,Hover 都不会触发 - 右下角状态栏显示的是
Plain Text还是真实语言(如TypeScript、Python)?若为前者,LSP 不介入,Hover 无数据源 - TS/JS 项目根目录有没有
tsconfig.json或jsconfig.json?哪怕空文件也必须存在,否则语义分析不启用 - Python 项目是否安装了
Pylance?仅装官方Python扩展不行,它不提供完整 Hover 文档支持 - 首次打开大项目时,LSP 是否还在索引?看状态栏右下角是否有
Loading...或旋转图标,等几秒再试
editor.hover.enabled 真的被关了吗?查法要准
这个开关默认为 true,但可能被覆盖。别只看 GUI 设置,重点检查三处:
- 全局设置:按
Ctrl+,搜索editor.hover.enabled,确认勾选 - 工作区设置:打开项目根目录下的
.vscode/settings.json,删掉或修正"editor.hover.enabled": false - 扩展干扰:禁用所有非官方扩展(尤其是 Copilot、Sesame AI 等),再测试——它们常静默劫持 Hover 渲染链路
Ctrl+K Ctrl+I 手动触发总失败?光标和时机最关键
这个快捷键调用的是 editor.action.showHover 命令,和自动悬停逻辑分离,但对光标位置更敏感:
- 必须把光标落在函数名/变量名的任意一个字母上,比如
map的m或p,不能停在map(的括号里 - 按之前先确认右下角语言模式正确,且 LSP 已就绪(状态栏无旋转图标)
- 刚保存文件后立刻按,比编辑中途按更容易成功——保存会强制触发 LSP 重分析
- 远程开发(SSH)场景下,网络延迟会导致 Hover 卡顿,此时
Ctrl+K Ctrl+I比鼠标悬停更可靠
想让 Hover 显示更多文档?靠的是注释格式和配置,不是开关
开启只是第一步,真正决定内容质量的是语言服务能否解析到结构化信息:
- JavaScript/TypeScript:函数上方必须用
/** */写 JSDoc,且不能和函数定义之间有空行;@param、@returns字段要规范 - Python:用 Google 或 NumPy 风格 docstring,Pylance 才能提取参数说明;单行
#注释无效 - 第三方库缺文档?例如
lodash只显示类型,运行npm install --save-dev @types/lodash补.d.ts - 不想看到 MDN 链接但保留 JSDoc?关掉
html.suggest.html5和css.mdnsuggest,再重载窗口
最常被忽略的一点:Hover 提示内容不会随注释实时更新——改完 JSDoc 或 docstring 后,必须保存文件,VSCode 才会重新解析并刷新提示。











