vscode typescript类型检查失效主因是tsserver未正确加载或配置错误：需确保tsconfig.json在根目录、include覆盖当前文件、排除node_modules冲突、选workspace版本并重启ts服务。

VSCode 的 TypeScript 类型检查失效，几乎从来不是代码本身的问题，而是语言服务（tsserver）没连上、连错了，或者被静默绕过了。

为什么改了 tsconfig.json 却没反应

最常见原因是配置根本没被加载——VS Code 只认工作区根目录下第一个有效的 tsconfig.json，且必须满足三个硬性条件：

• include 字段没覆盖你正在编辑的文件路径（比如只写了 ["src/**/*"]，但你在 test/utils.ts 里写代码，就得加 "test/**/*"）
• exclude 误删了 "node_modules"，导致类型定义冲突（尤其多版本 @types 共存时）
• 父目录存在另一个 tsconfig.json，VS Code 优先用了那个（路径上最近的），而不是你刚改的那个

验证方式：打开命令面板（Ctrl+Shift+P），执行 TypeScript: Go to Project Configuration，它会直接跳转到当前生效的配置文件。

tsserver 崩了却不报错，怎么确认和重启

tsserver 是独立 Node 进程，崩溃后 VS Code 状态栏可能还显示 “Running”，但实际已无响应。典型表现包括：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 悬停变量看不到类型
• Ctrl+Click 跳转失败或跳到声明文件开头
• 输入 arr. 后无方法补全

不要等它自愈，直接执行：Ctrl+Shift+P → 输入 TypeScript: Restart TS server → 回车。注意：该命令只在「已打开文件夹」的窗口中有效；单文件打开时，tsserver 会退化为 JavaScript 模式，不读 tsconfig.json。

为什么状态栏显示 TypeScript 版本，但类型检查还是宽松

右下角显示的版本号决定你看到的错误是否真实。如果显示的是 TS X.X.X (Bundled) 或 VS Code's Version，哪怕 tsconfig.json 里写了 "strict": true，你也看不到 Object is possibly 'undefined' 这类提示。

• 先运行 npm install --save-dev typescript，确保 node_modules/typescript 存在
• 再执行 TypeScript: Select TypeScript Version → 选 Use Workspace Version
• 如果没这个选项，说明 typescript 没装对，或路径被 typescript.tsdk 配置项错误指向了不存在的位置（检查 .vscode/settings.json 是否有该字段，删掉即可）

哪些配置项会静默关闭类型检查

以下任意一项都会让 "strict": true 形同虚设：

• 文件顶部有 // @ts-nocheck —— 它比 // @ts-ignore 更狠，整文件跳过检查
• tsconfig.json 中 "skipLibCheck": false 但 @types 包损坏，tsserver 可能卡住、不报任何错
• 用了 Vite/Vue 但没配 "types": ["vite/client"] 或缺失 vite-env.d.ts，导致 import.meta.env 被识别为 any，后续推导全变宽松

真正容易被忽略的是：VS Code 的类型检查和构建工具（如 tsc --noEmit、vitest typecheck）各自读各自的配置，缓存也不共享。改完 tsconfig.json 后不重启 tsserver，就等于没改。