vs code仅识别根目录下非空且命名严格的tsconfig.json；需手动重启TS服务，strict/noImplicitAny/skipLibCheck等影响类型检查，paths和monorepo需配置baseUrl、declaration及正确typescript版本。
VS Code 本身不编译 TypeScript，但能实时类型检查——关键在 tsconfig.json 配置是否被正确识别和加载。
为什么改了 tsconfig.json 但 VS Code 没反应？
VS Code 的 TypeScript 语言服务默认只读取工作区根目录下的 tsconfig.json（或 jsconfig.json），且必须满足：
-
tsconfig.json不能是空文件，至少含{}或有效配置 - 文件名必须严格为
tsconfig.json（大小写敏感，TsConfig.json不生效） - 如果项目有多个子目录含各自
tsconfig.json，VS Code 默认只认最外层；需打开对应子目录为根工作区，或用"extends"显式继承 - 修改后需手动触发重载：右键 TS 文件 → “TypeScript: Restart TS Server”，或快捷键
Ctrl+Shift+P→ 输入并执行Restart TS Server
compilerOptions 中哪些项真正影响 VS Code 的类型检查？
VS Code 的红波浪线（类型错误提示）由 TypeScript 语言服务驱动，它只关心 compilerOptions 中的静态检查相关配置，和是否生成 JS 无关。重点关注：
-
"strict": true—— 启用全部严格检查（推荐，否则any泛滥、隐式any不报错） -
"noImplicitAny": true—— 禁止隐式any（比strict更细粒度，常单独开启） -
"skipLibCheck": false—— 设为false才会检查node_modules/@types/xxx中的声明文件（默认true，容易漏掉类型问题） -
"target"和"lib"—— 影响全局变量可用性（如设"target": "ES2020"但没配"lib": ["ES2020"]，promise.allSettled就会标红） -
"moduleResolution": "node"—— 必须显式设置，否则路径别名（paths）或exports字段解析可能失败
如何让 VS Code 正确解析 paths 别名和 monorepo 中的本地包？
路径映射和跨包引用不是“开箱即用”的，需双向对齐：
-
tsconfig.json中配置"baseUrl": "."+"paths"，例如："paths": { "@utils/*": ["src/utils/*"], "@api": ["packages/api/src"] } - VS Code 不读取
jsconfig.json的paths，所以 TS 项目必须用tsconfig.json - monorepo 中引用本地包（如
packages/ui）时，确保该包有有效的types字段或index.d.ts，且其tsconfig.json已启用"declaration": true - 若仍提示“Cannot find module”，右键文件 → “TypeScript: select TypeScript Version” → 选 “Use Workspace Version”，确保使用的是项目
node_modules/typescript而非 VS Code 内置版本
最容易被忽略的是：VS Code 的类型检查依赖当前打开的文件是否被 include 或 files 显式纳入 tsconfig.json。如果只是把文件放在目录里但没出现在 "include" 数组中（比如忘了加 "src/**/*"），它就完全不会参与类型检查——连语法高亮都可能降级为普通 JS。