모듈을 찾지 못할 때는 import 문자열, 해석 전략, 후보 파일, 패키지 필드, 최종 결과 순서로 로그를 읽으면 원인을 빠르게 좁힐 수 있습니다.
로그는 import 문자열에서 시작해 상대 파일 후보와 패키지 조건으로 갈라지고, 첫 실패 지점이 설정 수정 위치를 알려준다.
./utils인지 @utils인지에 따라 상대 참조와 별칭 참조가 갈립니다.
node, bundler, classic 중 어떤 규칙을 적용했는지 확인합니다.
.ts, .tsx, .d.ts, index 파일을 어떤 순서로 찾았는지 봅니다.
types, main, exports 조건이 기대한 진입점을 가리키는지 봅니다.
성공 파일 경로 또는 실패 위치를 실제 설정과 대조합니다.
로그가 node_modules만 뒤진다면 tsconfig의 paths가 적용되지 않은 상황일 수 있습니다.
bundler 전략과 node 전략은 package.json 조건을 해석하는 기준이 다를 수 있습니다.
특정 @types만 허용한 설정에서는 자동 포함되던 선언이 제외될 수 있습니다.