VSCode不编译TypeScript，依赖本地tsc执行编译和类型检查；核心是正确识别tsconfig.json并启用内置TS语言服务，需确保项目安装TypeScript、存在有效tsconfig.json且版本≥4.5。
VSCode 本身不编译 TypeScript，它依赖本地 tsc（TypeScript Compiler）执行编译和类型检查；配置的核心是让 VSCode 正确识别项目中的 tsconfig.json 并启用内置的 TS 语言服务。
确认项目已安装 TypeScript 且有 tsconfig.json
VSCode 的 TS 支持默认启用，但前提是项目根目录下存在有效的 tsconfig.json，且本地或全局装有 typescript 包（版本建议 ≥ 4.5）：
- 运行
npm install --save-dev typescript（推荐本地安装，避免全局版本冲突） - 用
npx tsc --init生成基础tsconfig.json，不要跳过这步——没有它，VSCode 不会启动项目级类型检查 - 检查
tsconfig.json中"noEmit": false（默认为false），否则tsc命令不会输出 JS 文件
禁用自动保存时的保存即编译（避免干扰开发流）
VSCode 默认在保存 .ts 文件时触发一次类型检查（显示错误/警告），但如果你启用了 "compileOnSave": true，它还会调用 tsc 编译——这通常不必要，且可能与你自定义的构建流程（如 Webpack/Vite）冲突：
- 在项目级
tsconfig.json中移除或设为"compileOnSave": false - 确保工作区设置（
.vscode/settings.json）中没写"typescript.preferences.autoImportSuggestions.enabled": false这类无关项——它不影响编译，只关智能提示 - 类型检查始终生效（只要文件打开、
tsconfig.json存在），无需额外开启
手动触发编译：用终端运行 tsc，而非 VSCode 内置任务
虽然 VSCode 支持通过 Tasks: Run Build Task 调用 tsc，但直接在集成终端里运行更可控、报错更清晰：
- 打开集成终端（
Ctrl+`），执行npx tsc—— 它会读取当前目录下的tsconfig.json - 加
--watch启动监听：npx tsc -w，适合开发时持续编译（注意：它不重启，仅增量编译） - 若报错
Cannot find global type 'Promise'等，说明lib配置缺失，在tsconfig.json中补上："lib": ["ES2020", "DOM"]
遇到“TS Server crashed”或类型检查失效？优先查 node_modules 和版本对齐
VSCode 的 TS 语言服务（TSServer）崩溃或无法跳转定义，80% 源于本地 node_modules/typescript 与 VSCode 内置 TS 版本不一致，或 node_modules 损坏：
- 在 VSCode 中按
Ctrl+Shift+P→ 输入 “TypeScript: Select TypeScript Version”，选 “Use Workspace Version”（指向node_modules/typescript） - 删掉
node_modules和package-lock.json，重新npm install - 检查
tsconfig.json中"rootDir"和"outDir"是否指向真实存在的路径，路径错误会导致 TSServer 初始化失败
最易被忽略的是：VSCode 的 TS 支持完全依赖 tsconfig.json 的存在与合法性。哪怕只是多了一个逗号导致 JSON 解析失败，整个类型检查都会静默退化为“任何类型都允许”。建议每次修改 tsconfig.json 后，用 jsonc-parser 或 VSCode 自带的 JSON 验证功能快速校验。
