`tsconfig.json` 심층

"tsconfig 가 100+ 옵션. 대부분 시간 10개가 가장 중요."

대부분 중요한 옵션

`target` — emit 할 JavaScript 버전. `ES2022` 가 modern default; 더 옛 target 이 문법 down. 너의 runtime 과 match.
`module` — emit 할 module 시스템. Node ESM 엔 `NodeNext`, bundler 엔 `ESNext`, legacy Node 엔만 `CommonJS`.
`moduleResolution` — import 어떻게 resolve. Modern Node 엔 `NodeNext`, Vite/esbuild 엔 `Bundler`.
`strict` — 안전 meta-flag. 항상 `true`. 다음 트랙에서 자세히 다룸.
`esModuleInterop` — CommonJS interop 더 sane 하게. `true` 설정.
`skipLibCheck` — `.d.ts` 파일에 타입 체크 스킵. 대부분 프로젝트엔 `true` (더 빠르고, library 타입 어차피 못 고침).
`forceConsistentCasingInFileNames` — import 의 case mismatch 잡음 (`./MyFile` vs `./myfile`). 항상 `true`.
`outDir` — compile 된 JS 가는 곳 (emit 할 때만 중요).
`rootDir` — source TS 오는 곳. outDir 와 쌍.
`include` / `exclude` — 파일 패턴. `include: ['src']` 가 전형적; `exclude` 가 보통 node_modules + dist default.

tsconfig base

npm 의 `@tsconfig/*` 패키지가 흔한 시나리오용 pre-tuned tsconfig base 제공. extends: "@tsconfig/node20" 가 Node 20 의 옳은 default 상속. 이것들 써 — 지루한 부분 cover 하고 너가 프로젝트 specific 에 집중하게.

알려진 좋은 base 로 시작, 필수만 override. 새 tsconfig 의 모든 옵션 손-tuning 이 낭비; 커뮤니티가 sensible default 에 수렴. 그것들 써.

Code

2 tsconfig — 명시와 상속·json

// tsconfig.json — Node ESM 프로젝트용 sensible 2026 default.
{
  "compilerOptions": {
    "target": "ES2022",
    "module": "NodeNext",
    "moduleResolution": "NodeNext",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true,

    "verbatimModuleSyntax": true,
    "noUncheckedIndexedAccess": true,

    "outDir": "./dist",
    "rootDir": "./src"
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules", "dist"]
}

// Base 확장:
{
  "extends": "@tsconfig/node20/tsconfig.json",
  "compilerOptions": {
    "outDir": "./dist"
  },
  "include": ["src/**/*"]
}

Exercise

Fresh 프로젝트의 tsconfig.json 들고 와. compilerOptions 를 extends: "@tsconfig/node20" 으로 대체. tsc --noEmit 돌리고 뭐 (있으면) 깨지는지 봐. 깨짐이 보통 latent issue 잡는 strict flag.

Hint

모든 게 여전히 컴파일하면 너의 프로젝트가 이미 strict. 깨짐 나타나면 base 가 자기 일 함 — 옛 config 가 놓친 gap 잡음.

대부분 중요한 옵션

tsconfig base

Code

External links

Exercise

Progress

댓글 0