module resolution

모듈을 못 찾을 때 trace 로그 읽는 순서

해석 실패는 보통 import 문자열, 해석 전략, 패키지 메타데이터, 타입 파일 위치 중 하나가 다른 방향을 가리킬 때 발생합니다.

시작점

Cannot find module 메시지에서 import 문자열을 먼저 복사하고, 상대 경로인지 패키지 이름인지 구분합니다.

1

참조 종류 확인

상대 경로는 파일 위치, 패키지는 설정 기준으로 찾습니다.

2

전략 확인

node, node16, bundler는 exports와 확장자 규칙을 다르게 해석합니다.

3

별칭 확인

baseUrl과 paths 별칭은 번들러 설정도 알아야 합니다.

4

타입 진입점 확인

타입 진입점이 실제 JS API와 맞는지 봅니다.