VSCode悬停只显示函数签名而非参数说明，根本原因是语言服务器未解析出语义信息；需确保JSDoc/docstring格式规范、紧贴定义、项目配置（如tsconfig.json）完备，且文件语言模式正确。
VSCode 无法“自定义任意接口的悬停说明”，但能通过规范注释 + 正确语言服务，让接口（函数/方法）的悬停显示你写的文档内容——前提是注释格式、位置、项目配置三者全部对齐。
为什么悬停只显示 function foo() 而不是参数说明
这不是设置没开，而是语言服务器（LSP）压根没解析出语义信息。常见断点：
- TS/JS 项目缺失
tsconfig.json或jsconfig.json（哪怕空文件也要有） - Python 文件右下角显示的是
Plain Text，不是Python，Pylance 完全不介入 - JSDoc 注释没紧贴函数定义：中间隔了空行，或用了
//单行注释而非/** */ - Python 的 docstring 没写
Args:/Returns:字段，Pylance 默认忽略 - 光标停在
foo(的括号里，或字符串中，LSP 不触发 hover
JavaScript/TypeScript 接口悬停：JSDoc 必须这样写
必须用 /** */ 包裹，且紧贴函数声明上方，无空行。支持 @param、@returns、@example 等标准标签：
/**
* 计算用户积分上限
* @param {number} baseScore - 基础分（必须大于 0）
* @param {string} level - 用户等级，如 'vip' | 'pro'
* @returns {number} 计算后的积分上限值
* @throws {Error} 当 baseScore ≤ 0 时抛出错误
*/
function calcMaxPoints(baseScore, level) {
if (baseScore <= 0) throw new Error('baseScore must be positive');
return baseScore * (level === 'vip' ? 2 : 1.5);
}注意：@param 类型要用花括号包裹（{number}），类型名大小写敏感；@returns 后面不要跟冒号；保存文件后悬停才更新 —— 修改注释不保存，hover 内容不会变。
Python 接口悬停：docstring 风格决定能否显示
Pylance 主要识别 Google、NumPy 和 reStructuredText 风格。最稳妥的是 Google 风格，字段名必须全大写、冒号后空一格：
def fetch_user_data(user_id: int, timeout: float = 30.0) -> dict:
"""Fetch user profile and permissions from backend.
<pre class='brush:php;toolbar:false;'>Args:
user_id: Unique identifier for the user. Must be positive.
timeout: Maximum time to wait for response, in seconds.
Returns:
A dictionary containing 'profile' and 'permissions' keys.
Raises:
ValueError: If user_id is not a positive integer.
"""
# ... implementation</pre>关键点：
- 第一行必须是简短描述，单独成行
-
Args:、Returns:、Raises:必须顶格、全大写、带冒号 - 每个参数描述前不能缩进，冒号后空一格再写说明
- 不支持
//行注释或/* */块注释替代 docstring
悬停内容不刷新？别忘了这三件事
改完注释却看不到效果，90% 是卡在这三个地方：
- 没保存文件 —— VSCode 只在保存后重新解析 JSDoc/docstring
- 状态栏右下角 LSP 还在转圈（如显示
Initializing...或Loading...），等它静止再试 - 装了 Copilot、Sesame AI 等 AI 插件 —— 它们会劫持 hover，禁用后测试可快速定位
复杂点在于：C/C++ 等语言默认不带完整 LSP 支持，需额外安装 C/C++ 扩展并配置 c_cpp_properties.json；而自定义 DSL 或内部框架的接口，必须写插件注册 vscode.languages.registerHoverProvider，返回 vscode.Hover 对象，且 isTrusted: true 才能渲染 Markdown 链接和代码块 —— 这类需求已超出注释配置范畴。
