회사 프로젝트에서 tsc를 통해 컴파일했을때 tsconfig.tsbuild라는 파일이 생겼다.

어떤 역할의 파일인지 궁금해서 찾아본 내용을 정리하려고 한다.

incremental 옵션

tsconfig의 옵션 중 incremental이라는 옵션이 있다.

타입스크립트 3.4 버전부터 추가된 기능인데 문서에서는 아래와 같이 설명하고 있다.

Faster subsequent builds with the --incremental flag

tsconfig.tsbuildinfo

incremental 옵션을 통해서 빠르게 빌드할 수 있다고 설명한다. 이때 생성되는 파일이 tsconfig.tsbuildinfo 파일이다.

incremental 옵션이 활성화 됐을때 타입스크립트는 이전에 생성된(없다면 새로 생성) tsconfig.tsbuildinfo 파일을 찾는다.

찾은 tsconfig.tsbuildinfo 파일을 통해 최소한의 타입 체크와 빌드 파일 변경이 가능한 방법을 찾아 빌드한다.

즉, 더 빠른 빌드를 위한 파일이다

보통 tsconfig.tsbuildinfo 파일은 outDir에 만들어지지만 tsconfig의 tsBuildInfoFile 옵션을 통해 경로를 설정할 수 있다.

사용 방법은 공식 문서의 --tsBuildInfoFile 옵션 부분에서 확인할 수 있다.

incremental & noEmit 옵션

기존엔 noEmit옵션과 incremental 옵션을 함께 사용했을때 tsconfig.tsbuildinfo 파일이 만들어지지 않았다.

하지만 타입스크립트 4.0 버전부터 함께 사용할 수 있도록 바뀌었다.