[npm 오류] react-scripts 5.0.1 버전과 TypeScript 5.8.2 버전 충돌 해결하기

📌 react-scripts와 최신 TypeScript 버전 충돌

- TypeScript 5.8.2와 react-scripts 5.0.1 버전

- npm install / 라이브러리 설치 진행 시 아래와 같은 에러 발생

npm ERR! code ERESOLVE
npm ERR! ERESOLVE could not resolve
npm ERR! 
npm ERR! While resolving: react-scripts@5.0.1
npm ERR! Found: typescript@5.8.2
.
.
.
.

 

 

✅  Create React App의 react-scripts@5.0.1 버전과 typescript@5.8.2 버전(5.8.2)과 호환되지 않아 충돌 발생

 

📍해결 방법

📗 1. TypeScript 버전 다운그레이드

- react-scripts가 지원하는 TypeScript 4.x 버전과 호환되는 버전으로 다운그레이드

npm install typescript@4.9.5 --save-dev

 

📗 2. --legacy-peer-deps 플래그 사용  or 강제 설치

// --legacy-peer-deps 플래그 사용
npm install [설치하려는 패키지] --legacy-peer-deps
or
// 강제 설치
npm install [설치하려는 패키지] --force

 

 

✅ --legacy-peer-deps

• 새로운 방식으로 의존성을 관리하기 전의 구버전 방식으로 돌아갑니다.
• peerDependencies 관련 의존성 충돌을 무시하고 설치
• npm 7 이상에서 발생하는 의존성 문제를 해결할 때 사용

✅ --force

• 모든 종류의 의존성 충돌을 완전히 무시하고 강제로 설치하는 옵션
• 예상치 못한 부작용이 발생할 가능성이 더 높습니다
• --legacy-peer-deps로 해결되지 않는 경우 사용

📗 3. Vite 

-  빠른 개발 환경과 최신 기술 지원

-  React 18과 TypeScript 5.x를 함께 사용할 수 있는 환경을 손쉽게 설정할 수 있다.

npm create vite@latest my-app --template react-ts

 

 

✅ 1. TypeScript 버전 다운그레이드로 간단하게 해결! 

이후에 설치하려는 패키지 설치 진행 완료! 

 

✍️ 기록

 

감사합니다. 😁