VSCode类型悬停由TypeScript Server生成，关键在tsconfig.json配置、路径别名解析及JSDoc规范使用；缺失配置会导致显示any，正确设置baseUrl/paths、moduleResolution和skipLibCheck选项可提升悬停准确性。

VSCode 本身不提供“自定义类型悬浮提示”的设置入口——你看到的类型信息（如 string[]、User & { id: number }）完全由 TypeScript Server（tsserver）生成并返回，编辑器只负责渲染。想让悬停显示更准、更全、更可读，关键在配置和写法，而不是改 VSCode。

tsconfig.json 缺失或配置不当，类型悬停直接退化为 any

没有 tsconfig.json，VSCode 就不会启动完整的 TypeScript 语言服务，哪怕文件后缀是 .ts，悬停也只显示简化签名或 any。

• 空文件也行：{} 就足够触发基础服务
• "skipLibCheck": true 会屏蔽 node_modules/@types 中的类型定义，导致第三方库方法悬停只剩 any 或参数名缺失
• "moduleResolution": "node" 必须启用，否则自定义路径别名（如 @utils）无法被解析，悬停里看不到模块导出的类型
• 检查右下角状态栏是否显示 TypeScript 版本号；若显示 JavaScript，点击切换

JSDoc 注释对类型悬停无效，但能补充说明

在 TypeScript 文件中，/** */ 注释不会改变 tsserver 推导出的类型，但它可以叠加在类型信息之上，作为人工补充。

typescript-advanced-types

精通 TypeScript 高级类型系统，包括泛型、条件类型、映射类型、模板字面量类型与工具类型，用于构建类型安全的应用。在实现复杂类型逻辑、创建可复用类型工具

下载

• 必须紧贴类型声明/接口/泛型参数上方，中间不能有空行
• 对 type 或 interface 写 JSDoc，悬停时会先显示注释，再显示结构定义
• @template 能让泛型参数在悬停中带说明，比如：/** @template T @param {T} value */
• 别在 type Foo = string | number; 上方写 JSDoc——它不会出现在使用 Foo 的地方的悬停里；要写在 const x: Foo 的声明处才可能生效（且依赖 Pylance/TS 插件支持）

自定义类型别名悬停不显示？检查导入路径和语义完整性

你写了 import { MyType } from "@/types";，但悬停 MyType 只显示 any，大概率不是 hover 设置问题，而是路径没被正确解析。

• 确认 tsconfig.json 含 "baseUrl": "." 和 "paths" 配置，例如："@/*": ["src/*"]
• 确保 import 语句本身无报错（红线），VSCode 只会对“已成功解析”的模块提供完整悬停
• 如果类型定义在 .d.ts 文件中，该文件需被 include 或位于 typeRoots 路径下，否则 tsserver 视而不见
• 用 Ctrl+Click 测试能否跳转到 MyType 定义——跳转失败，悬停必然不完整

想注入运行时类型或外部文档？只能靠扩展，且极易卡住悬停

极少数场景需要悬停里显示 Swagger 示例、数据库 schema 或构建产物类型，这时必须开发扩展，但风险很高：

• 注册 vscode.languages.registerHoverProvider 时，language 必须是 typescript（不是 ts 或 javascript）
• provideHover 函数必须同步返回或返回 Thenable<hover></hover>，不能阻塞主线程
• 禁止在其中调用 fetch、fs.readFileSync 或遍历大型 AST——用户鼠标一停就卡住
• 返回的 MarkdownString 需设 isTrusted: true 才能渲染链接，但本地文件路径（file://）仍不被允许

真正难的不是写代码，是让自定义内容和 tsserver 原生类型提示共存且不冲突——多数情况下，修好 tsconfig.json 和导入路径，比写扩展更有效、更稳定。