VSCode悬浮提示默认启用，但显示“any”或空白主因是语言服务未就绪：语言模式错误、缺失jsconfig.json/tsconfig.json、未装Pylance、光标位置不准或AI插件劫持。
VSCode 的悬浮提示（Hover）默认是启用的，但实际能否看到“详细信息”，取决于语言服务是否就绪、光标位置是否准确、以及有没有被配置或插件干扰——不是开了 editor.hover.enabled 就万事大吉。
为什么悬停只显示“any”或空白，而不是函数签名和文档？
这通常不是功能被禁用，而是语言服务器没拿到足够语义信息。常见原因包括：
- 文件右下角语言模式显示为
Plain Text或Unknown→ 点击它手动切换成JavaScript、TypeScript或Python - TS/JS 项目缺少
jsconfig.json或tsconfig.json→ 没配置，LSP 不会做完整类型推导，hover 只能回退到基础语法层 - Python 项目没装
Pylance，或python.languageServer被设为Default（即旧版 Jedi）→ Pylance 才支持 docstring 渲染和类型精度更高的 hover - 光标停在
fetch(的括号里、空格后、或注释行 → 必须紧贴标识符任意一个字符，比如f或h上
如何让 Ctrl+K Ctrl+I 显示真正有用的详情？
Ctrl+K Ctrl+I 是手动触发 hover 的快捷键，但它依赖和鼠标悬停同一套底层机制。要让它生效且信息完整，得满足：
- 确保
editor.hover.enabled为true（即使关了它，Ctrl+K Ctrl+I仍可用，但内容可能受限） - TS/JS 项目必须有
jsconfig.json（哪怕空内容），否则 LSP 不加载完整语义分析能力 - Python 项目需在
.vscode/settings.json中明确指定："python.languageServer": "Pylance" - 首次打开大型项目时，等几秒再按 —— 状态栏右下角出现
Language Server ready或图标停止旋转后再试 - 如果仍只显示
function fetch(...)而没有 MDN 链接或参数说明，检查是否禁用了html.suggest.html5（HTML 文件）或css.mdnsuggest（CSS 文件）—— 它们只影响 Web 标准 API 的链接，不影响 JS/Python 自身的类型提示
悬停提示延迟太长或不粘滞怎么办？
默认 500ms 延迟对快速扫读很碍事，而提示一闪而过又看不清。调整这两个配置最实用：
-
editor.hover.delay：设为200到400之间较平衡；不建议设0，系统响应有下限，反而容易误触 -
editor.hover.sticky：设为true后，鼠标移出符号范围，提示框仍保留，点空白处或按Escape才关闭 - 注意：某些 AI 插件（如 Sesame AI、GitHub Copilot）会劫持 hover 事件，覆盖原生提示。若改完设置仍异常，先禁用它们测试
悬停里看不到自己写的 JSDoc / docstring？
不是 VSCode 问题，是注释格式或位置没被语言服务识别：
- JavaScript/TypeScript：JSDoc 必须用
/** */（不能是//或/* */），且紧贴函数定义上方，中间不能有空行 - Python：推荐用 Google 或 NumPy 风格 docstring，例如
"""Args:x (int): ..."""；纯"""simple string"""可能被忽略 - 函数是动态生成的（如通过
eval、new Function）、或来自未类型声明的第三方包 → hover 天然无法推导，只能靠 d.ts 或 stubs 补充 - VSCode 不解析
console.log这类内置函数的 JSDoc，它直接走浏览器/Node.js 的类型定义文件，所以你写再多注释也没用
真正容易被忽略的一点：悬停提示的内容深度，和你当前文件是否在工作区根目录下强相关。如果只是单独打开一个 .py 文件，没打开整个文件夹，Pylance 可能降级为“单文件模式”，连基础类型都推不出来——务必用 File > Open Folder 打开项目根目录。
