증분 컴파일과 빌드 최적화

대규모 타입스크립트 프로젝트에서는 코드 양이 늘어나면서 전체 컴파일 시간이 길어지기 쉽습니다.

코드를 조금 수정할 때마다 빌드를 오래 기다리면 생산성은 급격히 떨어집니다.

증분 컴파일(Incremental Compilation)과 다양한 빌드 최적화 기법은 이 문제를 줄이고 개발 워크플로우를 가속화하는 데 목적이 있습니다.

증분 컴파일

증분 컴파일(Incremental Compilation)은 TypeScript 3.4부터 도입된 기능으로, 이전 컴파일에서 변경된 파일과 그에 영향을 받는 파일만 다시 컴파일하는 방식입니다.

이를 통해 전체 프로젝트를 처음부터 다시 컴파일하는 것보다 훨씬 빠르게 빌드를 완료할 수 있습니다.

증분 컴파일을 활성화하려면 tsconfig.json 파일에 다음 옵션을 추가해야 합니다.

{
  "compilerOptions": {
    "incremental": true, // 증분 컴파일 활성화
    "tsBuildInfoFile": "./.tsbuildinfo", // 증분 빌드 정보를 저장할 파일 경로 (선택 사항)
    // ... 다른 컴파일러 옵션 ...
  },
  // ...
}

• "incremental": true: 이 옵션을 true로 설정하면 TypeScript 컴파일러는 이전에 컴파일된 정보를 기반으로 변경 파일과 영향을 받는 작업을 판별하고 재사용 가능한 결과를 활용합니다.
• "tsBuildInfoFile" (선택 사항): 컴파일러는 증분 빌드에 필요한 정보를 tsbuildinfo 파일에 저장합니다. 기본 경로는 outFile, rootDir, outDir와 설정 파일 위치에 따라 달라지므로, 고정된 위치가 필요하면 이 옵션으로 지정합니다. 일반적으로 이 파일은 .gitignore에 추가해 버전 관리에서 제외합니다.

incremental은 별도 실행 사이에 디스크의 빌드 정보를 재사용합니다. watch는 같은 프로세스에서 변경을 감시하고 상태를 재사용하는 기능입니다. 둘은 관련 있지만 동일한 설정은 아니며, 반응 시간은 실제 프로젝트에서 측정해야 합니다.

tsc --watch (Watch Mode)

개발 과정에서 코드를 수정할 때마다 수동으로 tsc 명령어를 실행하는 것은 번거롭습니다.

tsc --watch (또는 tsc -w) 명령어는 파일 시스템 변경을 감지하여 변경된 파일만 자동으로 증분 컴파일하도록 합니다.

tsc --watch

이 명령어는 터미널에서 계속 실행되며, 파일을 저장할 때마다 자동으로 다시 컴파일 과정을 시작합니다.

이는 개발 워크플로우에서 매우 중요한 기능입니다.

프로젝트 레퍼런스와 증분 빌드

아래 다이어그램은 증분 빌드가 파일 변경, 의존성 그래프, tsbuildinfo를 기준으로 어떤 프로젝트를 다시 빌드할지 판단하는 흐름을 보여줍니다.

9장 3절에서 다룬 프로젝트 레퍼런스(Project References)는 증분 컴파일을 여러 하위 프로젝트(모듈)에 걸쳐 확장하는 개념입니다.

tsconfig.json 파일에 composite: true를 설정한 하위 프로젝트들을 references로 연결하고, 최상위 tsconfig.json에서 이들을 참조합니다.

이 경우, 단순한 tsc 대신 tsc --build (또는 tsc -b) 명령어를 사용하여 증분 빌드를 수행합니다.

tsc --build

tsc --build는 다음과 같은 방식으로 증분 빌드를 최적화합니다.

• 의존성 순서 파악: references에 정의된 프로젝트 간의 의존성 그래프를 분석하여 올바른 빌드 순서를 자동으로 결정합니다.
• 하위 프로젝트별 증분 빌드: 각 하위 프로젝트에 대해 tsbuildinfo 파일을 사용하여 증분 컴파일을 수행합니다.
• 변경된 프로젝트만 빌드: 하위 프로젝트의 소스 코드가 변경되었거나, 해당 프로젝트가 의존하는 프로젝트가 변경되었을 때만 해당 하위 프로젝트를 다시 빌드합니다. 예를 들어 common의 공개 선언 변화는 ui에 영향을 줄 수 있습니다. 내부 구현만 바뀌고 선언이 같으면 소비자의 일부 작업을 재사용할 수 있으며, 옵션·산출물·캐시 상태도 빌드 판정에 영향을 줍니다.

이는 모노레포와 같은 대규모 멀티-패키지 프로젝트에서 빌드 시간을 획기적으로 줄이는 데 핵심적인 역할을 합니다.

기타 빌드 최적화 기법

증분 컴파일 외에도 타입스크립트 빌드 시간을 최적화하는 데 도움이 되는 몇 가지 방법들이 있습니다.

증분 컴파일과 다양한 빌드 최적화 기법은 대규모 타입스크립트 프로젝트의 개발 경험을 크게 좌우합니다.

incremental: true와 tsc --build로 증분 빌드를 활성화하고, 필요에 따라 skipLibCheck, isolatedModules, noEmit 같은 컴파일러 옵션을 조정하며, 더 빠른 번들러/트랜스파일러를 활용하는 것은 생산성 극대화에 중요합니다.

이러한 최적화 전략을 적절히 조합해 프로젝트 빌드 시간을 효과적으로 관리하세요.

빌드가 느려졌을 때는 도구 이름보다 먼저 타입 검사, 변환, 번들링, 테스트 중 어느 단계가 병목인지 분리해야 합니다.

최적화 설정은 로컬과 CI에서 같은 기준으로 검증되어야 합니다.

아래는 최적화를 평가하는 측정 절차이며, 이 절에서 수행한 벤치마크 결과를 뜻하지 않습니다.