1

error TS2304: Cannot find name 'process'.

1

{ "compilerOptions": { "types": ["node"] } }

1

产物出现在 dist/src/index.js 而不是 dist/index.js

1

{ "compilerOptions": { "rootDir": "./src", "outDir": "./dist" } }

1

{ "compilerOptions": { "ignoreDeprecations": "6.0" } }

1
2
3
4
5
6
7
8

// 🛑 6.0 下不写 types，@types/node 不会被加载
{}

// ✅ 显式列出需要的全局类型包
{ "compilerOptions": { "types": ["node", "vitest/globals"] } }

// ⚠️ 恢复 5.x 的「全部加载」行为（不推荐，会拖慢编译）
{ "compilerOptions": { "types": ["*"] } }

1
2
3
4
5
6
7
8

// 手动指定 lib：想用 ES2023 的数组方法但要 DOM
{ "compilerOptions": { "target": "ES2020", "lib": ["ES2023", "DOM", "DOM.Iterable"] } }

// 后端项目：不要 DOM
{ "compilerOptions": { "lib": ["ES2023"] } }

// 前端项目：要 DOM + DOM.Iterable
{ "compilerOptions": { "lib": ["ES2023", "DOM", "DOM.Iterable"] } }

1
2
3
4
5

// 标准装饰器（新项目推荐）
{ "compilerOptions": {} }

// 旧版装饰器（Angular、TypeORM 等依赖元数据的框架需要）
{ "compilerOptions": { "experimentalDecorators": true, "emitDecoratorMetadata": true } }

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

// 库的典型产物配置
{
  "compilerOptions": {
    "declaration": true,
    "declarationMap": true,   // 使用者能跳回你的源码 🔥
    "sourceMap": true,
    "outDir": "./dist",
    "rootDir": "./src"
  }
}

1
2
3
4
5
6
7
8
9

// 现代项目的互操作配置
{
  "compilerOptions": {
    "isolatedModules": true,
    "verbatimModuleSyntax": true,
    "erasableSyntaxOnly": true,       // 只在需要 Node 直跑时开
    "forceConsistentCasingInFileNames": true
  }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

// 🛑 erasableSyntaxOnly 下报 TS1294
export enum E { A }
export namespace N { export const x = 1; }
export class K { constructor(public a: number) {} }

// ✅ 替代写法
export const E = { A: "A" } as const;
export type E = (typeof E)[keyof typeof E];

export const N = { x: 1 };

export class K {
  a: number;
  constructor(a: number) { this.a = a; }
}

1
2
3
4
5
6
7
8

// 根 tsconfig.json（solution 文件，只有引用不含源码）
{
  "files": [],
  "references": [
    { "path": "./packages/core" },
    { "path": "./packages/web" }
  ]
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

// packages/core/tsconfig.json
{
  "compilerOptions": {
    "composite": true,
    "declaration": true,
    "rootDir": "./src",
    "outDir": "./dist"
  },
  "include": ["src"]
}

1
2
3

npx tsc --build          # 按拓扑顺序增量构建
npx tsc --build --clean  # 清理
npx tsc --build --force  # 强制全量

1
2
3
4
5
6
7
8

// 迁移期配置
{
  "compilerOptions": {
    "allowJs": true,
    "checkJs": true,
    "noEmit": true
  }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

// tsconfig.base.json（团队共享）
{
  "compilerOptions": {
    "strict": true,
    "noUncheckedIndexedAccess": true,
    "target": "ES2022",
    "module": "esnext",
    "moduleResolution": "bundler",
    "skipLibCheck": true,
    "verbatimModuleSyntax": true
  }
}

1
2
3
4
5
6

// 各包继承
{
  "extends": "./tsconfig.base.json",
  "compilerOptions": { "outDir": "./dist" },
  "include": ["src"]
}

1
2

{ "extends": "@tsconfig/strictest/tsconfig.json" }
{ "extends": "@tsconfig/node22/tsconfig.json" }

1

npx tsc --showConfig

1
2
3
4
5

{
  "compilerOptions": {
    "noErrorTruncation": true   // 不截断超长类型错误，排查时必开 🔥
  }
}