Vue 프로젝트 개발 시 Node.js를 실행 환경으로 사용하는 것이 일반적입니다. 하지만 때때로 Node.js 버전이 너무 높아서 Vue 프로젝트 시작 시 오류가 발생하는 경우가 있습니다. 본 문서에서는 이와 같은 Node.js 버전 충돌로 인한 Vue 프로젝트 시작 오류를 해결하는 몇 가지 방법을 소개합니다.

먼저, 현재 설치된 Node.js 버전을 확인해야 합니다. 명령 프롬프트 또는 터미널에서 다음 명령어를 입력하여 확인할 수 있습니다:

node -v

출력되는 버전이 Vue 프로젝트에서 지원하는 버전과 다를 경우, 버전을 낮춰야 합니다. 다음은 몇 가지 일반적인 버전 관리 방법입니다.

1. nvm을 사용한 Node.js 낮은 버전 설치

nvm (Node Version Manager)은 여러 Node.js 버전을 쉽게 전환하고 관리할 수 있도록 돕는 도구입니다. nvm을 사용하여 낮은 버전의 Node.js를 설치하는 단계는 다음과 같습니다:

1. nvm을 다운로드하고 설치합니다. 공식 문서를 참조하여 설치를 진행합니다.
2. 터미널 또는 명령 프롬프트를 열고, 필요한 낮은 버전의 Node.js를 설치하기 위해 다음 명령어를 입력합니다:

   nvm install 10.24.1  # 예시: 10.24.1 버전 설치

3. Node.js 버전이 성공적으로 변경되었는지 확인하려면 다음 명령어를 사용합니다:

   node -v

4. npm 버전도 함께 변경되었는지 확인합니다:

   npm -v

5. Vue 프로젝트를 정상적으로 시작할 수 있는지 확인합니다:

   npm run serve

2. package.json 파일의 Node.js 의존성 버전 수정

nvm을 사용하지 않으려면, Vue 프로젝트의 package.json 파일에 명시된 Node.js 의존성 버전을 수동으로 수정할 수도 있습니다. 구체적인 절차는 다음과 같습니다:

1. 터미널 또는 명령 프롬프트를 열고 Vue 프로젝트의 루트 디렉토리로 이동합니다.
2. package.json 파일이 있는 디렉토리로 이동하기 위해 다음 명령어를 사용합니다 (package.json이 프로젝트 루트에 있다고 가정):

   cd .  # 프로젝트 루트 디렉토리

3. Node.js 의존성 버전을 수정하기 위해 다음 명령어를 사용합니다:

   npm uninstall node  # 현재 버전의 node 의존성 패키지 제거
   npm install node@10.24.1 --save-dev  # 지정된 버전의 node 의존성 패키지 설치 및 devDependencies에 추가

4. Node.js 의존성 버전이 성공적으로 수정되었는지 확인합니다:

   node -v

3. package.json 스크립트 수정

특정 빌드 스크립트에서 Node.js의 OpenSSL 레거시 공급자 사용이 필요한 경우, package.json 파일 내의 관련 스크립트를 다음과 같이 수정할 수 있습니다:

"scripts": {
  "dev": "set NODE_OPTIONS=--openssl-legacy-provider && vue-cli-service serve --open",
  "build:prod": "set NODE_OPTIONS=--openssl-legacy-provider && vue-cli-service build --report",
  "build:stage": "set NODE_OPTIONS=--openssl-legacy-provider && vue-cli-service build --mode staging",
  "preview": "set NODE_OPTIONS=--openssl-legacy-provider && node build/index.js --preview"
}

위에 제시된 방법들은 인터넷에서 수집된 정보이며 참고용으로만 사용하시기 바랍니다.