모듈 해석 전략

모듈 해석 전략

TypeScript 컴파일러는 moduleResolution과 경로 설정을 바탕으로 import 대상의 소스, 선언 파일, 패키지 진입점을 찾습니다.

해석 시작

import 문자열 읽기

상대 경로, 절대 별칭, 패키지 이름인지에 따라 탐색 규칙이 달라집니다.

import x
옵션

Node 방식 선택

moduleResolution은 Node 생태계 규칙과 최신 번들러 환경 중 어떤 기준을 따를지 정합니다.

node16
경로 매핑

별칭과 기준점

baseUrl과 paths를 쓰면 짧은 import가 실제 디렉터리로 매핑됩니다.

paths
추적

해석 로그 확인

traceResolution으로 어떤 후보 파일을 확인했고 왜 실패했는지 볼 수 있습니다.

traceResolution