React 프로젝트 생성 및 React 버전 다운그레이드 방법

React를 사용해 프론트엔드 프로젝트를 시작하면서 최신 버전의 React(2024년 12월 27일 기준, React 19 버전)에서 문제가 발생한 경험을 공유합니다. 이를 해결하기 위해 React의 버전을 낮춰 프로젝트를 설정하는 방법을 정리했습니다.

---

1. 프로젝트 폴더 생성

먼저 작업을 진행할 프로젝트 폴더를 생성합니다. 아래 명령어를 순서대로 실행하세요.

cd \ 
mkdir app\frontend 
cd app\frontend

 

위 명령어를 실행하면 C:\app\frontend 폴더가 생성됩니다.

---

2. React 프로젝트 설치

React 프로젝트를 초기화하려면 npx create-react-app 명령어를 실행합니다.

npx create-react-app .

create-react-app 명령어는 프로젝트 초기 설정을 자동으로 구성해주며, React의 최신 버전(2024년 12월 27일 기준, React 19 버전)을 설치합니다.

---

3. React 버전 문제 및 해결 방법

React 19 버전에서 문제가 발생하는 경우, React와 React DOM의 버전을 낮춰야 합니다. 아래 명령어를 통해 React와 React DOM의 버전을 18.3.1로 다운그레이드할 수 있습니다.

npm install react@18.3.1 react-dom@18.3.1

---

4. package.json 확인

버전이 제대로 적용되었는지 확인하려면 프로젝트 폴더의 package.json 파일을 열어 아래 내용을 확인합니다.

"dependencies": { 
    "react": "18.3.1", 
    "react-dom": "18.3.1", ... 
}

React와 React DOM의 버전이 18.3.1로 표시된다면 성공적으로 버전이 낮춰진 것입니다.

---

결론

React 프로젝트 초기 설정 시, 최신 버전의 React에서 문제가 발생할 수 있습니다. 이럴 때 React와 React DOM의 버전을 낮추는 방법을 통해 문제를 해결할 수 있습니다. 위 단계를 참고하여 안정적인 환경에서 React 프로젝트를 시작해보세요! 😊