typescript在vscode中开箱即用但需对齐tsconfig.json配置：tsc全量检查而vscode默认快速检查，须确保tsconfig.json存在、路径正确、使用本地ts版本，并启用strict、baseurl/paths等关键编译选项，同时 reload window 生效配置。

TypeScript 在 VSCode 里基本开箱即用，不需要额外配置就能获得语法高亮、跳转、类型提示——但想真正用好，关键在 tsconfig.json 的细节和编辑器行为对齐。

为什么新建项目后 tsc 报错但 VSCode 不报？

VSCode 内置的 TypeScript 语言服务默认使用“快速类型检查”（仅检查当前打开文件及其直接依赖），而命令行 tsc 默认走完整项目检查（受 tsconfig.json 全局控制）。两者行为不一致，就会出现“VSCode 看着没问题，tsc 却一堆错误”的情况。

• 确保项目根目录有 tsconfig.json，哪怕只是空对象 {}，否则 VSCode 可能 fallback 到默认宽松配置
• 检查 tsconfig.json 中是否漏写了 "include" 或写错了路径（比如用了 "src/**/*" 却没加引号或斜杠方向不对）
• VSCode 右下角点击 TypeScript 版本号，确认它正在使用项目本地安装的 typescript（而非全局或内置版本）
• 执行 npx tsc --noEmit 手动触发一次全量检查，比对输出和 VSCode 问题面板是否一致

tsconfig.json 必设的几个关键字段

很多项目只配了 target 和 module，结果类型检查松散、路径别名失效、或者 import 提示乱跳。这几个字段不设好，VSCode 的智能提示就容易“猜错”。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• "compilerOptions": { "strict": true } —— 启用严格模式，避免隐式 any、未初始化属性等隐患；VSCode 的波浪线提示会立刻变多，但这是好事
• "baseUrl": "./" + "paths": { "@/*": ["src/*"] } —— 否则 VSCode 无法解析路径别名，Ctrl+Click 会跳到错误位置
• "skipLibCheck": false —— 设为 true 会跳过 node_modules 类型检查，VSCode 的第三方库提示可能缺失或不准
• "resolveJsonModule": true —— 如果读 JSON 文件，不加这个，VSCode 会报“无法导入模块”

VSCode 插件和设置里真正要关/开的项

VSCode 自带 TS 支持足够强，装一堆插件反而容易冲突。重点调的是几个开关，不是装新东西。

• 禁用 JavaScript and TypeScript Nightly 插件（如果装了）—— 它会覆盖内置 TS 服务，常导致类型提示延迟或崩溃
• 在设置里搜 typescript.preferences.includePackageJsonAutoImports，设为 "auto"，不然从 package.json 导入时没有自动补全
• 开启 editor.quickSuggestions 对 strings 和 other 的支持，否则模板字符串里 ${ 后不提示变量
• 关闭 typescript.preferences.useAliasesForReexports（设为 false），否则重构时可能把 export * from 'x' 错误展开成具体路径

最常被忽略的是：VSCode 的 TS 服务不会自动监听 tsconfig.json 变更，改完必须手动重载窗口（Cmd/Ctrl+Shift+P → Developer: Reload Window），否则所有改动都白配。