tsconfig.json 新手配置

官方手册不分重点,实在对新手不友好, 可以直接复制下面配置.

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",

    "sourceMap": true,
    "outDir": "dist",

    "esModuleInterop": true,
    "strict": true,
    "skipLibCheck": true
  },
  "include": ["src"]
}

核心配置

1️⃣ target

TS 最终编译成什么版本的 JS？ 选择 ES2020 = 现代 Node 全支持。

2️⃣ module

用什么 JS 模块体系？ CommonJS 最常用。

这两个概念解释起来一大篇, 但新手可以写死无需困扰

常用配置

3️⃣ sourceMap: true

让断点调试 TS 时显示你写的代码，而不是 dist 下编译后的代码。

4️⃣ outDir: "dist"

编译后的 JS 放在哪里？ 真正必备项，官方文档根本没突出这点。

5️⃣ include: ["src"]

告诉 TS “只编译 src 里的代码”。 不然它可能会扫描整个文件夹，造成奇怪的编译行为。

额外说明

esModuleInterop: 让 import 写法更好用（推荐开）

strict: 类型检查更严格（建议开）

skipLibCheck: 忽略 node_modules 的类型检查，减少报错

你可以照抄这份配置开发完整的 Node + TypeScript 项目，无需深究几十个 tsconfig 参数。