Node.js는 다양한 버전이 존재하고, 각 프로젝트마다 요구하는 Node.js의 버전이 다를 수 있습니다. 이러한 상황에서 개발자가 겪는 가장 큰 문제는 바로 여러 버전의 Node.js를 관리하는 것입니다. 이러한 문제를 해결하기 위해 탄생한 것이 바로 Node Version Manager (nvm)입니다. nvm은 여러 버전의 Node.js를 쉽게 설치하고 관리할 수 있도록 도와주는 툴입니다. 이 글에서는 nvm의 주요 기능과 설치 방법, 그리고 활용 사례를 소개하겠습니다.

nvm의 주요 기능

nvm은 다음과 같은 주요 기능을 제공합니다:

  1. 다양한 Node.js 버전 관리: nvm을 사용하면 원하는 버전의 Node.js를 손쉽게 설치하고, 필요에 따라 버전을 전환할 수 있습니다.
  2. 전역 패키지 관리: nvm은 각 Node.js 버전에 대해 독립적인 전역 패키지 설치를 지원합니다. 이로 인해 프로젝트마다 필요한 패키지를 별도로 관리할 수 있습니다.
  3. .nvmrc 파일 지원: 특정 프로젝트에서 사용해야 하는 Node.js 버전을 정의할 수 있는 .nvmrc 파일을 지원하여, 프로젝트에 맞는 Node.js 버전을 자동으로 설정할 수 있습니다.
  4. POSIX 호환: nvm은 POSIX 호환 bash 스크립트로 작성되어 있어 다양한 Unix 계열 시스템에서 사용할 수 있습니다.

nvm 설치 및 업데이트

nvm 설치는 매우 간단합니다. 아래의 커맨드를 터미널에 입력하면 nvm이 설치됩니다.

설치 스크립트

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

이 스크립트는 nvm을 설치하고, 필요한 환경 변수를 설정합니다. 설치가 완료되면, 아래 커맨드를 입력해 설치를 확인할 수 있습니다.

command -v nvm

이 명령어가 nvm을 반환하면, 설치가 성공적으로 완료된 것입니다.

업데이트

nvm을 업데이트하려면, 다음 커맨드를 사용합니다.

cd ~/.nvm
git pull

이렇게 하면 nvm의 최신 버전으로 업데이트됩니다.

nvm 사용법

Node.js 버전 설치

nvm을 사용하면 원하는 Node.js 버전을 쉽게 설치할 수 있습니다. 아래 예제를 통해 확인해 보세요.

nvm install 14

위 명령어는 Node.js의 14버전을 설치합니다. 설치가 완료되면, 다음 명령어로 현재 사용 중인 Node.js 버전을 확인할 수 있습니다.

node -v

Node.js 버전 전환

다양한 프로젝트를 진행하다 보면, 서로 다른 Node.js 버전이 필요할 때가 있습니다. 이때 nvm을 사용하면 손쉽게 전환할 수 있습니다.

nvm use 14

위의 명령어는 14버전으로 전환합니다. 이 외에도 사용 가능한 모든 버전을 확인하려면 다음 명령어를 사용할 수 있습니다.

nvm ls

이 명령어는 설치된 모든 Node.js 버전 목록을 보여줍니다.

.nvmrc 파일 사용하기

특정 프로젝트에 필요한 Node.js 버전을 자동으로 관리하고 싶다면, 프로젝트 루트 디렉토리에 .nvmrc 파일을 생성하고 원하는 버전을 작성합니다.

echo "14" > .nvmrc

그 후, 해당 디렉토리에서 아래 명령어를 실행하면 .nvmrc에 정의된 Node.js 버전으로 자동 전환됩니다.

nvm use

실무에서의 활용 시나리오

nvm은 특히 여러 Node.js 버전을 사용해야 하는 대규모 프로젝트에서 매우 유용합니다. 예를 들어, A팀과 B팀이 각각 Node.js 12버전과 14버전으로 개발 중인 경우, nvm을 통해 팀원들은 각자의 개발 환경에서 필요한 버전을 쉽게 설치하고 전환할 수 있습니다.

또한, CI/CD 환경에서도 nvm을 활용할 수 있습니다. Docker를 사용할 때, nvm을 설치하고 특정 Node.js 버전을 사용할 수 있도록 구성하면, 지속적으로 동일한 개발 환경을 유지할 수 있습니다.

비슷한 도구와 비교

nvm 외에도 Node.js 버전 관리를 위한 도구로는 n과 Volta가 있습니다. n은 더 간단한 CLI 인터페이스를 제공하며, Volta는 패키지 설치와 버전 관리가 통합된 솔루션입니다. 하지만 nvm은 가장 널리 사용되고 있으며, 커뮤니티의 지원이 풍부하여 안정성이 높습니다.

마무리

nvm은 Node.js 개발자에게 필수적인 도구입니다. 여러 버전의 Node.js를 쉽게 관리할 수 있어, 다양한 프로젝트에서 발생할 수 있는 버전 충돌 문제를 해결해 줍니다. 개인 프로젝트부터 대규모 팀 프로젝트까지, nvm을 통해 개발 환경을 유연하게 관리해 보세요.

GitHub에서 nvm을 확인하고 설치해 보세요: nvm GitHub 링크