VSCode 原生支持 TypeScript，无需额外配置即可实现实时报错、跳转定义等功能，前提是项目根目录存在有效的 tsconfig.json 且文件被 TS 语言服务接管；常见问题包括 tsconfig 缺失、文件被 exclude、未以文件夹形式打开、语言模式错误等。
TypeScript 在 VSCode 里不需要“配置环境”也能直接写、实时报错、跳转定义——因为 VSCode 原生支持 TS，真正要做的只是确保项目有 tsconfig.json，且没被错误覆盖或忽略。
为什么新建 .ts 文件没提示、不报错、F12 跳不到定义？
这不是 VSCode 的问题，而是当前文件没被 TypeScript 语言服务“接管”。常见原因：
-
tsconfig.json缺失，或放在了子目录但没被根目录识别（TS 默认只向上查找一个tsconfig.json） - 文件在
exclude或files列表中被显式排除（比如写了"exclude": ["node_modules", "dist"]却漏掉了"src"） - VSCode 打开的是单个 .ts 文件，而非整个文件夹（
File → Open Folder才能触发项目级 TS 配置加载） - 工作区启用了 JavaScript 语言模式（右下角显示
JavaScript），手动切回TypeScript即可
tsconfig.json 最小可用配置怎么写？
别抄网上几十行的模板。开发阶段只要保证类型检查和基础编译即可，以下是最简有效配置：
{
"compilerOptions": {
"target": "ES2020",
"module": "commonjs",
"lib": ["ES2020", "DOM"],
"strict": true,
"skipLibCheck": true,
"forceConsistentCasingInFileNames": true,
"outDir": "./dist",
"rootDir": "./src",
"esModuleInterop": true,
"resolveJsonModule": true
},
"include": ["src/**/*"]
}
注意：outDir 和 rootDir 必须成对出现，否则 tsc --watch 会报错；include 推荐用通配，别用 files 列表——新增文件不用改配置。
怎么一键编译 + 实时监听 + 断点调试？
VSCode 不需要额外插件，靠内置任务 + launch.json 就能闭环：
- 编译：终端运行
tsc --watch（需全局或本地装typescript），它会自动监听并输出到outDir - 调试：按
Ctrl+Shift+P→ 输入Debug: Open launch.json→ 选Node.js (Preview)→ 修改program指向编译后的.js文件（如"program": "${workspaceFolder}/dist/index.js"） - 关键细节：如果源码在
src/，必须在tsconfig.json中启用sourceMap（加一行"sourceMap": true），否则断点打在 .ts 上无效 - 快捷替代：用
ts-node直接跑 .ts（npm install -D ts-node），launch.json中设"runtimeExecutable": "npx", "args": ["ts-node", "${file}"]，省去编译步骤但无法 attach 到长期进程
常见陷阱：Node.js 版本、模块解析、路径别名全失效
这些不是 VSCode 的锅，而是 tsc 和 Node 运行时的行为差异导致：
-
type: "module"项目里，tsc默认仍输出commonjs，会导致import报错——必须配"module": "nodenext"和"moduleResolution": "nodenext" - 用了
paths别名但跳转失败？确认tsconfig.json里有"baseUrl": "."，且 VSCode 没缓存旧配置（重启 TS 服务：Ctrl+Shift+P→Typescript: Restart TS server） - Node 报
Cannot find module 'xxx'？那是运行时找不到，跟 VSCode 无关——用ts-node或生成.js后用node --preserve-symlinks启动
最常被忽略的一点：VSCode 的类型提示依赖 tsserver，而它只读 tsconfig.json，完全不看 package.json 里的 type 或 exports 字段。想让路径别名、条件导出生效，得靠 compilerOptions 显式声明。
