VS Code 原生支持 TypeScript，但需正确配置 tsconfig.json 并理解其与 TS 语言服务协同机制；状态栏显示 TS 版本可确认服务启用，本地安装优先于内置版本，缺失 tsconfig.json 会导致类型检查宽松等问题。
vs code 原生支持 typescript 开发，不需要额外安装插件就能语法高亮、跳转定义、智能补全和基础类型检查——但要真正用好，关键在于正确配置 tsconfig.json 和理解 vs code 如何与 typescript 语言服务协同工作。
如何确认 TypeScript 语言服务已启用
VS Code 默认内置 TypeScript 语言服务（版本通常略滞后于最新 npm 版本），但会优先使用项目本地安装的 typescript 包。打开一个 .ts 文件后，状态栏右下角会显示当前 TS 版本号（如 Version 5.3.3）。点击它可切换为“Use Workspace Version”或“Use VS Code’s Version”。
- 若状态栏无版本显示，检查是否打开了包含
tsconfig.json的文件夹（不是单个 .ts 文件） - 若提示 “Cannot find module 'typescript'”，说明项目未安装，运行
npm install -D typescript - 不推荐全局安装
typescript：VS Code 不会自动识别全局tsc，且多项目版本易冲突
tsconfig.json 是核心，不是可选项
没有 tsconfig.json，VS Code 会以默认配置（target: es5, module: commonjs, 无严格检查）加载文件，导致类型检查宽松、路径别名不生效、装饰器报错等——这些都不是 VS Code 的问题，而是 TS 编译器没被正确告知你的意图。
- 初始化：在项目根目录运行
npx tsc --init，生成基础配置 - 必调项：
"strict": true、"esModuleInterop": true、"skipLibCheck": true（提升编辑体验） - 路径别名需配
"baseUrl": "./"+"paths"，否则import utils from '@utils'会标红且无法跳转 - 修改后无需重启 VS Code，TS 服务会自动重载配置
常见报错与对应修复点
很多“TS 报错但在终端 tsc 能过”的情况，本质是 VS Code 使用的 TS 版本或配置路径与命令行不一致。
-
Cannot find name 'React'：缺少@types/react，或tsconfig.json中"types"未包含["react"] -
Property 'xxx' does not exist on type 'yyy'：检查是否漏写了declare module或index.d.ts，且该文件被"include"覆盖 - JS 文件里出现 TS 提示：在设置中关闭
javascript.suggest.autoImports，或在jsconfig.json中设"checkJs": false - 保存时没触发类型检查：VS Code 默认只做编辑时检查（semantic checking），不等同于
tsc --noEmit；如需保存即校验，可配置"editor.codeActionsOnSave": { "source.organizeImports": true }，但类型错误本身不会阻止保存
最常被忽略的是：VS Code 的 TS 支持高度依赖 tsconfig.json 的存在位置和内容完整性。哪怕只是删掉一个逗号，都可能导致整个语言服务降级为“仅语法高亮”。与其反复查插件，不如先确认 tsconfig.json 在工作区根目录、能被 tsc --showConfig 正确解析、且没有语法错误。
