VSCode悬浮提示显示变量类型需TypeScript服务正常运行且有类型上下文。若显示any、空白或“Loading…”，通常是tsserver未启动、缺少tsconfig.json、类型标注缺失或JSDoc未保存所致。
VSCode 悬浮提示默认就能显示变量类型，但前提是 TypeScript 语言服务已正确加载且代码具备可推导的类型上下文。如果悬停只显示 any、空白或“Loading…”，基本不是设置开关没开，而是类型系统没接上。
确认 TypeScript 服务是否真在运行
悬浮提示依赖 tsserver 提供语义信息，它不会因为你开了 .ts 文件就自动工作。
- 右下角状态栏必须显示类似
TypeScript 5.6 (Workspace)—— 如果显示JavaScript或空白，点击它手动切换语言模式 - 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），执行Developer: Toggle Developer Tools，在 Console 中搜tsserver或TypeError，看是否有初始化失败、路径找不到或版本冲突报错 - 项目根目录必须存在
tsconfig.json（哪怕内容只是{}），否则 VSCode 会退化为 JS 模式，不启用完整类型推导
为什么悬停总是显示 any
any 是类型推导失败的明确信号，不是配置问题，而是代码本身切断了类型流。
- 变量声明未初始化也无类型标注：
let x;→ 推导为any；应写成let x: string = ""或let x = "hello" - 函数参数缺失标注：
function foo(a) { return a.length; }→a是any；需补function foo(a: string) - 用了
// @ts-ignore或// @ts-nocheck，尤其在导入语句上方，会直接让后续推导失效 - 从纯 JS 库导入（如
lodash）但没装@types/lodash，或tsconfig.json中设了"skipLibCheck": true
让复杂类型真正“展开”显示
默认悬停只展示简化类型（如 string[]），联合类型、泛型、条件类型常被折叠。要看到真实结构，得主动触发：
- 光标停在变量上，按
Ctrl+Space（Windows/Linux）或Cmd+Space（macOS），顶部会弹出完整类型签名 - 按
F12跳转到定义：对类型别名或接口能直接看到源码；对推导出的匿名类型，VSCode 会在弹窗中渲染其展开结构 - 确保
tsconfig.json中"skipLibCheck": false（默认值），否则node_modules中的类型声明不会穿透进悬停
JS 文件里也能有类型提示
纯 JS 项目无法用 TS 类型系统，但配合 jsconfig.json 和 JSDoc 可获得近似效果：
- 项目根目录加
jsconfig.json，内容至少含{"compilerOptions": {"checkJs": true}} - 变量/函数上方写标准 JSDoc：
/** @type {Map<string number>} */ const cache = new Map();</string> - 函数参数用
@param标注，返回值用@returns，VSCode + JSDoc 解析器会把它们显示在悬停中 - 注意：JSDoc 必须紧贴定义，中间不能有空行；
//单行注释不被识别为文档注释
最常被忽略的一点：修改了 JSDoc 或类型标注后，必须保存文件，VSCode 才会重新解析并更新悬停内容——改完不保存，悬停永远还是旧的。
