悬停提示不显示文档主因是语言服务器（LSP）未就绪或语义分析失败，而非设置关闭；需确保TS/JS项目含jsconfig.json/tsconfig.json、Python文件语言模式正确、JSDoc/docstring格式规范且紧贴定义、修改后保存文件触发重解析。
悬停提示不显示文档？先确认语言服务是否就绪
不是设置没开，而是语言服务器（LSP）压根没加载或语义分析失败。常见现象是只看到 function add()，没有参数说明和 @param 内容。
实操建议：
- TS/JS 项目必须存在
jsconfig.json或tsconfig.json（哪怕空文件），否则 TSC/Prettier 不启动完整类型推导 - 检查右下角语言模式：Python 文件显示
Plain Text→ 点击切换为Python，否则 Pylance 不介入 - JSDoc 必须紧贴函数定义，中间不能有空行；单行注释
//不被识别，必须用/** */ - Python 的 docstring 要符合 Google/NumPy 风格，且包含
Args:和Returns:字段，Pylance 才解析 - 修改 JSDoc 或 docstring 后必须保存文件，VSCode 才会重新解析并更新提示
想改悬停延迟又不卡？别设 editor.hover.delay 为 0
设成 0 并不会“立刻弹出”，而是跳过等待、立刻向语言服务器发请求——结果常是空白框闪一下，或卡住 2～3 秒。这不是配置错了，是暴露了语言服务本身的冷启动延迟。
实操建议：
- 多数人手感最稳的区间是
200～400：比默认500更快响应，又避开服务刚唤醒时的抖动 - 别全局设
0，除非你确认语言服务器响应极快（比如小 Python 脚本 + Pylance 缓存已热） - 改完后不用重启 VSCode，但需悬停新代码行才能生效（旧提示可能还缓存着）
- 若没反应，先检查
editor.hover.enabled是否为true；再打开开发者工具 Console，看是否有HoverProvider not found报错
不同语言扩展各自管延迟？查专属配置项
是的。Pylance、Volar、Rust Analyzer 这类扩展通常不读取 editor.hover.delay，而是用自己内部的缓存和触发策略。表现就是：你在 JS 文件里把 delay 调到 100，但悬停 Python 文件还是慢半拍。
实操建议：
- Volar v1.10+ 支持
volar.hover.delay - Rust Analyzer 的 hover 行为受
rust-analyzer.hoverActions.enable影响，但它不控制延迟；目前无公开delay配置项 - 找不到专属配置时，最有效的是缩小语言服务器负担：在
settings.json中加"files.watcherExclude": { "**/node_modules": true, "**/dist": true } - 临时禁用非必要扩展（尤其 ESLint、Tailwind CSS IntelliSense、IntelliCode），再试一次，快速定位干扰源
真要注入自定义内容？靠插件开发，但注意匹配规则
95% 的需求靠规范注释 + 正确配置就能满足。真要注入外部文档或 DSL 提示，才需注册 vscode.languages.registerHoverProvider。
实操建议：
- Hover 不生效的主因是
documentSelector与languageId不匹配：用Ctrl+Shift+P→ 输入Developer: Toggle Developer Tools→ Console 中执行vscode.window.activeTextEditor?.document.languageId确认真实 ID -
package.json中contributes.languages列表要和activationEvents里的onLanguage:xxx一致 - 返回的
vscode.MarkdownString不支持任意 HTML，仅支持有限内联 Markdown（如**bold**、`code`）；所有反引号、星号、下划线需手动转义，或传true启用严格转义：new vscode.MarkdownString(text, true) -
provideHover是同步函数，但可返回Thenable；所有 I/O 操作（读文件、调 API）必须异步，否则导致悬停卡顿甚至超时
真正容易被忽略的是：hover 提示内容不会自动刷新 —— 修改了 JSDoc 或 docstring 后，必须保存文件，VSCode 才会重新解析并更新提示。
