先确认 TypeScript 服务是否正常启动：检查右下角是否显示 TS 版本号，若为 JavaScript 则手动切换；打开 Developer Tools 查 tsserver 报错；确保项目根目录存在 tsconfig.json；悬停显示 any 多因变量未初始化、参数无标注或缺失 JSDoc/@types。
类型悬停提示不显示？先确认 TypeScript 服务是否正常启动
VSCode 的类型提示依赖内置的 TypeScript 语言服务，不是单纯靠文件后缀或配置就能自动生效。常见现象是把 .js 文件重命名为 .ts，但悬停时仍只显示 any 或完全没提示——这往往意味着 TS 服务没加载成功。
实操建议：
- 打开一个
.ts文件，在右下角状态栏查看是否显示 TypeScript 版本号（如TS 5.3）；若显示JavaScript，点击它并手动切换为TypeScript - 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），运行命令Developer: Toggle Developer Tools，在 Console 中搜索tsserver或TypeError，确认无崩溃日志 - 检查工作区根目录是否存在
tsconfig.json；即使内容为空（{}），也能触发 TS 服务启用；没有该文件时，VSCode 可能退化为 JavaScript 模式
悬停看到的是 any 而不是具体类型？检查类型推导上下文
TS 类型推导高度依赖上下文。悬停显示 any 不一定是配置问题，更可能是代码本身削弱了类型信息。
常见原因与应对：
- 变量声明未赋初值且无类型标注：
let x;→ 推导为any；改用let x: string | number;或直接初始化let x = "hello"; - 函数参数未标注，且调用时传入
any值：function foo(a) { return a.length; }→a为any；应写成function foo(a: string) { ... } - 使用了
// @ts-ignore或// @ts-nocheck抑制检查，会切断类型流；仅在必要时添加，且尽量缩小作用范围 - 从第三方 JS 库导入（无
.d.ts）时，VSCode 默认无法推导；可安装对应@types/xxx包，或在tsconfig.json中启用"allowJs": true并配合"checkJs": true
想看更详细的类型结构？用快捷键展开类型定义
默认悬停只显示简化后的类型（如 string[]），但复杂联合、泛型或条件类型常被折叠。需要主动展开才能看清真实结构。
操作方式：
- 将光标停在变量/表达式上，按
Ctrl+Space（Windows/Linux）或Cmd+Space（macOS）触发智能提示，顶部会显示完整类型签名 - 按
F12跳转到定义，对类型别名或接口可直接看到源码；对推导出的匿名类型，VSCode 会在弹出框中渲染其展开结构 - 在悬停窗口中，鼠标悬停在类型文本上，会出现小眼睛图标 ?️，点击即可“固定”该悬停面板，方便反复比对
- 如果类型过长被截断，可在
settings.json中设置"typescript.suggest.autoImports": false减少干扰项，让悬停更聚焦
为什么在 JS 文件里也能看到 TS 类型提示？这是 JS 支持特性
VSCode 对 .js 文件也提供基于 JSDoc 和类型推导的提示能力，但它和 TS 模式是两套机制，行为有差异。
关键区别：
- JS 文件中写
/** @type {Map<string number>} */ const m = new Map();</string>，悬停会显示Map<string number></string>；但若漏掉@type，推导结果通常比 TS 文件更弱 - JS 模式下不校验类型错误，所以即使写了
/** @type {number} */ let x = "abc";，也不会报错，仅提示可能不匹配 - JS 文件启用 TS 类型检查需在
jsconfig.json中设置"checkJs": true，否则悬停仅基于简单推导，不走完整 TS 编译流程 - TS 文件中若含
export {}或import，会被识别为模块；JS 文件缺这些时，默认为脚本，JSDoc 类型注释可能不生效
类型推导不是黑盒，它直接受限于你写的每行代码是否提供足够线索。最常被忽略的其实是 tsconfig.json 里的 "strict" 开关——关掉它，很多隐式 any 就不会报错，但悬停也再看不到精确类型。
