Vite Version 8 Package Installation Issue & Solution

Context

Vite 8 릴리스 이후 개발자들이 npm install, pnpm add, yarn add 실행 시 ERESOLVE unable to resolve dependency tree 오류와 패키지 불완전 설치 현상을 경험했다. 이는 Vite 8의 엄격한 의존성 규칙이 이전에 무시되던 충돌을 노출시켜 발생했다.

Technical Solution

• node_modules, package-lock.json, pnpm-lock.yaml, yarn.lock 전체 제거 후 npm cache clean --force 실행으로 캐시 초기화
• Node.js 버전을 18 LTS 이상으로 업그레이드, 가능하면 Node 20 사용 권장
• npm install --legacy-peer-deps 또는 npm install --force 플래그로 엄격한 피어 의존성 검사 우회
• pnpm 또는 yarn으로 패키지 매니저 변경: pnpm이 Vite 8 의존성을 더 안정적으로 처리
• npm update 또는 npx npm-check-updates -u 실행으로 모든 의존성을 최신 버전으로 업데이트
• esbuild 수동 설치 또는 npm rebuild esbuild로 네이티브 모듈 재구성
• package.json에서 버전 범위(^, ~) 대신 정확한 버전 지정(예: "1.2.3")
• npm config set legacy-peer-deps true로 전역 설정 변경 (신중히 사용)

Key Takeaway

Vite 8의 설치 문제는 Vite 자체 결함이 아닌 오래된 의존성, 비호환 패키지, 환경 불일치가 주원인이므로, 체계적인 캐시 초기화, Node.js 버전 일관성, 단일 패키지 매니저 사용으로 대부분의 설치 문제를 해결할 수 있다.