설정 파일

tsconfig 변환 기준

`tsc --init`으로 만든 설정 파일은 프로젝트마다 TypeScript 버전과 컴파일 규칙을 재현 가능하게 맞추는 기준점입니다.

tsconfig.json

프로젝트 안의 컴파일 규칙표

npx tsc npx tsc --noEmit

명령은 설정 파일을 읽어 어떤 파일을 검사하고 어떤 JavaScript로 바꿀지 결정합니다.

include

검사할 파일 범위

소스 폴더만 포함해 예제 파일이나 빌드 결과가 섞이지 않게 합니다.

strict

타입 검사 강도

null, any, 함수 인자 같은 느슨한 지점을 더 일찍 드러냅니다.

target

출력 문법 수준

실행 환경이 이해할 JavaScript 버전과 모듈 방식을 맞춥니다.

outDir

결과물 위치

변환된 JavaScript를 소스와 분리해 프로젝트 구조를 정리합니다.

디버깅 순서

node와 npm이 정상인데 컴파일 결과가 예상과 다르면 코드보다 먼저 tsconfig의 파일 범위, strict 설정, 출력 위치를 확인하면 원인 추적이 빨라집니다.