Vite빌드
Vite Failed to resolve import — 모듈 경로 해석 실패
Failed to resolve import "<path>" from "<file>". Does the file exist?
한 줄 해결: Vite가 import 경로를 찾지 못한 것으로, 미설치·경로 오타·확장자/alias 문제가 원인입니다. dev 서버 재시작이 필요한 경우도 있습니다.
이런 증상일 때
Vite dev/build에서 "Failed to resolve import"가 뜹니다. 새로 설치한 패키지나 alias 경로에서 자주 발생합니다.
원인
- 패키지 미설치 또는 잘못된 상대경로
- resolve.alias 미설정 또는 tsconfig paths와 불일치
- 새 의존성 설치 후 dev 서버가 옛 의존성 캐시를 사용
해결 방법
1
설치·경로 확인
패키지 설치 여부와 상대경로 철자를 확인합니다.
npm install <pkg>2
alias 설정
vite.config의 resolve.alias를 tsconfig paths와 맞춥니다.
resolve: { alias: { '@': '/src' } }3
dev 서버 재시작·캐시 정리
새 의존성 설치 후엔 dev 서버를 재시작하거나 optimize 캐시를 지웁니다.
rm -rf node_modules/.vite && npm run dev💡 예방: 새 패키지 설치 후 dev 서버를 재시작하는 습관을 들이고, alias는 한 곳(vite.config)에서 관리하세요.
Viteimportresolvealias빌드