tsconfig.json 완전 가이드 — strict, paths, target 옵션 정리

{
  "compilerOptions": {
    // 컴파일 옵션
  },
  "include": ["src/**/*"],    // 포함할 파일
  "exclude": ["node_modules"], // 제외할 파일
  "extends": "./tsconfig.base.json", // 다른 설정 파일 상속
  "references": []             // 프로젝트 레퍼런스
}

{
  "compilerOptions": {
    "strict": true  // 아래 모든 strict 옵션을 한 번에 켬
  }
}

{
  "compilerOptions": {
    "noUnusedLocals": true,           // 사용하지 않는 지역 변수 에러
    "noUnusedParameters": true,       // 사용하지 않는 매개변수 에러
    "noFallthroughCasesInSwitch": true, // switch fallthrough 방지
    "noUncheckedIndexedAccess": true,   // 인덱스 접근 시 undefined 가능성 체크
    "exactOptionalPropertyTypes": true  // 선택적 속성에 undefined 직접 할당 금지
  }
}

// noUncheckedIndexedAccess: true
const arr = [1, 2, 3];
const value = arr[0]; // number | undefined (범위 밖 접근 가능성)

const obj: Record<string, number> = { a: 1 };
const val = obj['b']; // number | undefined

{
  "compilerOptions": {
    "target": "ES2020",         // 변환할 ECMAScript 버전
    "module": "ESNext",         // 모듈 시스템
    "outDir": "./dist",         // 출력 폴더
    "rootDir": "./src",         // 소스 루트 폴더
    "declaration": true,        // .d.ts 선언 파일 생성
    "declarationMap": true,     // .d.ts.map 소스맵 생성
    "sourceMap": true,          // .js.map 소스맵 생성
    "noEmit": true,             // JS 파일을 생성하지 않음 (번들러 사용 시)
    "removeComments": true      // 주석 제거
  }
}

{
  "compilerOptions": {
    "module": "ESNext",              // 번들러 사용 시
    "moduleResolution": "bundler",   // Webpack, Vite 등

    // 또는 Node.js 프로젝트에서
    "module": "NodeNext",
    "moduleResolution": "NodeNext"
  }
}

{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@/*": ["src/*"],
      "@components/*": ["src/components/*"],
      "@utils/*": ["src/utils/*"],
      "@types/*": ["src/types/*"]
    }
  }
}

{
  "compilerOptions": {
    "target": "ES2017",
    "lib": ["dom", "dom.iterable", "esnext"],
    "module": "esnext",
    "moduleResolution": "bundler",
    "strict": true,
    "noEmit": true,
    "jsx": "preserve",
    "incremental": true,
    "plugins": [{ "name": "next" }],
    "paths": {
      "@/*": ["./src/*"]
    }
  },
  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx"],
  "exclude": ["node_modules"]
}

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "NodeNext",
    "moduleResolution": "NodeNext",
    "strict": true,
    "outDir": "./dist",
    "rootDir": "./src",
    "declaration": true,
    "sourceMap": true,
    "esModuleInterop": true,
    "skipLibCheck": true
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules", "dist"]
}

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "ESNext",
    "moduleResolution": "bundler",
    "strict": true,
    "outDir": "./dist",
    "rootDir": "./src",
    "declaration": true,
    "declarationMap": true,
    "sourceMap": true
  },
  "include": ["src/**/*"]
}

{
  "include": [
    "src/**/*",           // src 폴더 하위 모든 파일
    "types/**/*.d.ts"     // 커스텀 타입 선언
  ],
  "exclude": [
    "node_modules",
    "dist",
    "**/*.test.ts",       // 테스트 파일 제외
    "**/*.spec.ts"
  ]
}

// tsconfig.base.json — 공통 설정
{
  "compilerOptions": {
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true
  }
}

// tsconfig.json — 프로젝트별 설정
{
  "extends": "./tsconfig.base.json",
  "compilerOptions": {
    "target": "ES2020",
    "outDir": "./dist"
  }
}