본문 바로가기

오류 해결 기록

[Node.js] 노드 버전 오류

 

글로벌로 Node를 설치했는데 그로인해 모든 프로젝트에 영향이 가는 이슈 발생



글로벌로 Node.js를 설치하면, 기본적으로 모든 프로젝트에서 그 글로벌 버전을 사용하게 된다.

이는 특정 프로젝트가 특정 Node.js 버전을 필요로 하는 경우 문제가 될 수 있기 때문에 이를 해결하기 위해 Node.js 버전 관리 도구를 사용하면 각 프로젝트마다 다른 Node.js 버전을 쉽게 관리할 수 있다.

가장 많이 사용하는 Node.js 버전 관리 도구는 **nvm (Node Version Manager)**이며,

nvm을 사용하면 프로젝트별로 다른 Node.js 버전을 사용할 수 있다.

 

1. nvm 설치

먼저 nvm을 설치해야 하고, 터미널을 열고 아래 명령어를 입력한다.

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
command -v nvm

 

 

2. Node.js 버전 설치 및 사용

nvm을 사용하면 원하는 Node.js 버전을 설치할 수 있습니다.


1. 프로젝트에 맞는 버전 설치

  • 최신 LTS(Long Term Support) 버전을 설치 방법
nvm install --lts

 

  • 특정 버전 설치 방법
nvm install 14.17.0

 

2. 설치된 Node.js 버전 확인 하기

nvm ls

 


특정 프로젝트에서 사용할 Node.js 버전 설정

nvm use 14.17.0

 


 

프로젝트 별로 Node.js 버전 유지

프로젝트별로 특정 Node.js 버전을 유지하려면, 각 프로젝트의 루트 디렉토리에 .nvmrc 파일을 생성하고 해당 파일에 원하는 Node.js 버전을 명시하면 된다.

 

cd /home/user/myproject
echo "14.17.0" > .nvmrc
nvm use

 

이렇게 하면 프로젝트마다 다른 Node.js 버전을 쉽게 관리할 수 있어, 글로벌로 설치된 Node.js 버전으로 인해 발생하는 문제를 방지할 수 있다.