TS · MODULE

TypeScript 모듈 해석 결정 트리

import 문 하나가 실제 파일과 타입 선언으로 이어지려면 compiler option과 package.json 규칙을 순서대로 통과합니다.

TypeScript 모듈 해석 결정 트리 구조

resolution
specifier상대/절대/패키지 import
paths/baseUrl별칭 매핑 먼저 확인
package exportstypes/import 조건 확인
extensions.ts, .tsx, .d.ts 후보 탐색
specifierpaths/baseUrlpackage exportsextensions

TypeScript 모듈 해석 결정 트리 기준

점검
bundlerVite/Next 환경은 bundler 해석을 쓰는 경우가 많습니다.
node16ESM/CJS 경계와 package type 영향을 함께 봅니다.
paths 한계TS 해석만 바꾸므로 런타임 번들러 설정도 맞춰야 합니다.
실패 진단traceResolution으로 어떤 후보에서 실패했는지 확인합니다.