VSCode报TS语法错误但代码可正常编译运行，主因是编辑器使用的TypeScript版本与项目不一致或tsconfig.json未被正确加载；需右下角选“Use Workspace Version”、确认include/exclude覆盖源码、Vue/Vite项目补全vite-env.d.ts及types配置，并重启TS Server验证。
VSCode 报 TS 语法错误，但代码实际能编译通过、运行正常——这基本不是你写错了，而是编辑器用的 TypeScript 版本和项目不一致，或者语言服务没加载对配置。
TS 语法报错但 tsc --noEmit 不报？先看右下角版本号
VSCode 状态栏右下角显示的 TypeScript X.X.X 必须是 (Workspace)，而不是 Bundled 或 VS Code's Version。否则：
- 新语法（如
using声明、const断言增强、export type *）直接不识别 -
noImplicitAny、exactOptionalPropertyTypes等开关行为降级或失效 - 错误行号和
tsc --noEmit输出不一致，调试时容易误判
执行 Ctrl+Shift+P → 输入 TypeScript: Select TypeScript Version → 选 Use Workspace Version。如果该选项不出现，说明 node_modules/typescript 不存在，先运行 npm install --save-dev typescript。
tsconfig.json 配置生效了没？include/exclude 是关键
即使 "strict": true 写得再全，VSCode 也不会检查没被 include 或 files 覆盖的文件。常见漏配场景：
-
"include": ["src/**/*"]，但测试文件在test/下 → 补上"test/**/*" -
"exclude": ["node_modules", "dist"]，却漏写了"build"，导致构建产物里的 .d.ts 干扰类型推导 - 根目录外层有父级
tsconfig.json（比如 monorepo 的 workspace 根），VSCode 默认用路径上“最近”的那个，可能根本不是你改的那个
验证方式：在任意 TS 文件里故意写个 const a: never = 123，如果没红波浪线，大概率是配置没进语言服务视野。
Vue / Vite 项目里 .vue 文件报 TS 错误？缺 vite-env.d.ts 或 types
Vue 单文件组件里的 defineComponent、import.meta.env、ref() 类型丢失，90% 是因为没正确接入类型定义：
- 确认
tsconfig.json的compilerOptions.types包含"vite/client"（Vite 项目）或"vue"（Vue CLI） - 确保
src/vite-env.d.ts存在且内容为：/// <reference types="vite/client" /> declare module '*.vue' { import type { DefineComponent } from 'vue' const component: DefineComponent<{}, {}, any> export default component } - 如果用的是 Vue 3.4+ + TypeScript 5.4+，还需确认
"moduleResolution": "bundler"已启用，否则import类型解析会出问题
重启 TS Server 是最快验证手段，别删缓存
改完 tsconfig.json 或切换完 TypeScript 版本后，90% 的“还是报错”问题，都是语言服务缓存没刷新。不要反复关 VSCode、删 CachedData，直接：
-
Ctrl+Shift+P→ 输入TypeScript: Restart TS server→ 回车 - 等几秒，所有波浪线自动重算；如果错误消失，说明前面某步配置起效了
- 如果仍不消失，再回头检查
node_modules/typescript/lib/tsserver.js是否可读、typescript.tsdk路径是否被工作区.vscode/settings.json错误覆盖
最常被忽略的一点：VSCode 的 TS 语言服务只认它自己加载的那一套配置，和终端里跑的 tsc 是两个进程——哪怕你在终端里 tsc --noEmit 一切正常，编辑器里照样可能满屏红波浪线。
