tsconfig 기본

기본 패턴

json

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "ESNext",
    "strict": true,
    "outDir": "dist"
  },
  "include": ["src"]
}

tsconfig.json은 TypeScript 컴파일러가 어떤 파일을 읽고 어떤 기준으로 검사하고 어디로 출력할지 정하는 프로젝트 설정 파일입니다.
compilerOptions 안에는 target, module, strict, outDir 같은 핵심 옵션이 들어갑니다.
include와 exclude는 검사 대상 파일 범위를 제어해, 테스트 코드나 빌드 산출물을 구분하는 데 도움이 됩니다.
실제 프로젝트 문제 상당수는 문법보다 설정에서 시작하므로, tsconfig는 언어 학습만큼 중요합니다.
특히 런타임 환경(Node, 브라우저, 번들러)에 맞는 module과 target을 고르는 감각이 중요합니다.

bash

npx tsc --init

json

{
  "compilerOptions": {
    "strict": true,
    "noEmit": true
  }
}

tsconfig를 복붙만 해 두면, 나중에 모듈 오류나 빌드 충돌이 났을 때 원인을 찾기 어렵습니다. 최소한 target, module, strict, noEmit이 무엇을 하는지는 직접 이해하고 가는 편이 좋습니다.

2 sources