moduleResolution

모듈 해석 전략 점검

모듈 해석은 import 문자열을 기준으로 소스 파일, package.json, 타입 선언 파일을 찾아 연결하는 규칙입니다.

상대 경로

파일 위치에서 찾기

./ 또는 ../로 시작하면 현재 파일 기준으로 후보 확장자를 탐색합니다.

./lib/math
node 전략

Node 방식 탐색

node_modules, package.json, index 파일을 고려해 모듈을 찾습니다.

moduleResolution: "node"
bundler 전략

현대 번들러와 정렬

package exports와 조건부 내보내기를 번들러 동작에 맞춰 해석합니다.

"bundler"
traceResolution

탐색 과정 출력

왜 특정 파일을 찾지 못했는지 컴파일러의 후보 경로를 확인합니다.

tsc --traceResolution
경로 별칭 baseUrl과 paths를 쓰면 런타임 도구도 같은 별칭을 이해해야 합니다.
타입 선언 JavaScript 파일을 찾았더라도 .d.ts가 없으면 타입 정보가 비어 있을 수 있습니다.
classic 회피 과거 방식인 classic은 새 프로젝트에서 거의 선택하지 않습니다.

모듈 해석 오류는 감으로 고치기보다 TypeScript가 어떤 후보를 찾는지 추적하면 빠르게 좁혀집니다.