VS Code 不编译 TypeScript，而是依赖本地 tsc 和 tsconfig.json 提供类型检查；需确保项目含有效 tsconfig.json、使用工作区 TypeScript 版本、并手动运行 npx tsc 编译。
VS Code 本身不编译 TypeScript，它依赖本地安装的 tsc（TypeScript 编译器）和项目级配置来提供错误检查与构建能力。关键不是“在 VS Code 里配编译”，而是让 VS Code 正确识别并使用你项目的 tsconfig.json 和已安装的 tsc。
确认项目已正确初始化 TypeScript 环境
VS Code 的 TS 支持完全基于项目根目录是否存在有效的 tsconfig.json。没有这个文件，编辑器只会做基础语法高亮，不会执行类型检查或路径解析。
- 运行
npm init -y && npm install --save-dev typescript安装本地tsc - 执行
npx tsc --init生成默认tsconfig.json（不要用全局tsc -init，容易权限或版本错乱） - 检查生成的
tsconfig.json中"noEmit": false（若需输出 JS）或"noEmit": true（仅检查，常见于纯编辑场景） - 确保
"include"或"files"覆盖你的源码路径，例如"include": ["src/**/*"]
VS Code 不报错？先检查 TypeScript 版本和工作区设置
VS Code 自带一个 TypeScript SDK，但它可能和你项目安装的版本不一致，导致类型检查行为异常（比如该报错不报、或报错位置偏移）。
- 打开任意
.ts文件 → 按Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS）→ 输入 “TypeScript: Select TypeScript Version” - 务必选择 “Use Workspace Version”（对应
node_modules/typescript），而非 “Use VS Code’s Version” - 检查状态栏右下角：点击 TS 版本号，确认显示的是你项目里的版本（如
5.3.3），不是5.0.4这类 VS Code 内置旧版 - 如果仍不报错，尝试关闭所有窗口，重新用
code .在项目根目录打开（避免 VS Code 误用父级tsconfig.json）
手动触发编译：别依赖保存自动编译
VS Code 默认不会在保存时自动调用 tsc 编译，它只做语言服务（错误提示、跳转、补全）。要生成 JS 文件，必须显式运行编译命令。
- 终端中执行
npx tsc—— 使用项目本地版本，读取tsconfig.json配置 - 加
--watch参数启用监听：npx tsc --watch，适合开发时自动编译 - 不要在
settings.json里配"typescript.preferences.includePackageJsonAutoImports"之类无关选项来“解决编译问题”，它不影响tsc行为 - 若需保存即编译，推荐用
tasks.json配置任务，但注意：VS Code 任务默认不继承node_modules/.bin路径，应写"command": "npx", "args": ["tsc"]而非直接"command": "tsc"
常见错误现象与对应排查点
很多“VS Code 不检查 TS 错误”的问题，其实卡在几个具体环节上：
-
Cannot find module 'xxx'：检查tsconfig.json中"baseUrl"和"paths"是否配置正确，且"moduleResolution"为"node"（默认值） - 修改了
tsconfig.json但没反应：重启 TS 服务 ——Ctrl+Shift+P→ “TypeScript: Restart TS Server” - JS 文件里出现 TS 类型提示：说明当前打开的文件被识别为 TS（比如文件名是
index.tsx但内容是 JS），检查右下角语言模式是否为 “TypeScript React” 而非 “JavaScript” - 第三方库无类型提示：确认已安装对应
@types/xxx，且tsconfig.json中"typeRoots"未错误覆盖默认值（删掉该字段通常更安全）
最常被忽略的是：VS Code 的 TS 支持本质上是“被动跟随”，它不会替你决定如何编译，也不会自动修复 tsconfig.json 的逻辑错误。一旦类型检查失效，优先验证 tsc --noEmit 命令行是否报同样错误——如果命令行也不报，说明不是编辑器问题，而是配置或代码本身的问题。
