본문 바로가기
React

[React] React 프로젝트마다 다른 버전 설치해도 괜찮을까? 완벽 정리

by haheehee 2025. 2. 6.

📌 React 프로젝트마다 다른 버전 설치해도 괜찮을까?

React 프로젝트를 여러 개 작업하다 보면 각 프로젝트에서 다른 React 버전을 사용해야 할 때가 있습니다.

그런데, 한 폴더에서 React 17을 쓰고, 다른 폴더에서 React 18을 설치해도 괜찮을까요?

결론부터 말하면, 각 프로젝트 폴더마다 React 버전을 다르게 설치해도 문제가 없습니다.

✅ React 프로젝트별 버전이 충돌하지 않는 이유

  • 각 프로젝트는 독립적인 패키지 환경을 가짐
  • 다른 프로젝트의 node_modules/ 폴더와 충돌하지 않음
  • package.jsonpackage-lock.json을 기반으로 버전이 고정됨

🔹 현재 프로젝트에서 사용 중인 React 버전 확인하기

터미널에서 해당 프로젝트 폴더로 이동 후 아래 명령어를 실행하세요.

npm list react

실행하면 다음과 같이 현재 프로젝트에서 사용 중인 React 버전이 표시됩니다.

my-project@1.0.0
└── react@18.2.0

🛠 각 프로젝트에서 다른 React 버전 설치하는 방법

📍 프로젝트 A (React 17 사용)

cd project-a
npm install react@17.0.2 react-dom@17.0.2

📍 프로젝트 B (React 18 사용)

cd project-b
npm install react@18.2.0 react-dom@18.2.0

각 프로젝트 폴더에서 React를 설치하면, 다른 프로젝트에는 영향을 주지 않습니다.

⚠ 전역(Global) 설치는 주의하세요!

npm install -g react

이렇게 전역(global)으로 React를 설치하는 경우, 시스템 전체에서 동일한 React 버전을 사용하게 됩니다.

결론: 글로벌 설치보다는 각 프로젝트 폴더별로 React를 설치하는 것이 안전합니다.

✅ 정리

  • 각 프로젝트의 React 버전은 독립적이다.
  • 각 프로젝트의 node_modules/ 폴더가 별도로 관리되므로 충돌하지 않는다.
  • npm install react@원하는버전을 실행하면 해당 프로젝트에만 적용된다.
  • 글로벌 설치(npm install -g react)는 가급적 피하는 것이 좋다.
  • Node.js 버전까지 다르게 관리하려면 nvm을 사용하면 된다.

이제 프로젝트마다 원하는 React 버전을 설치해서 개발할 수 있습니다.

댓글