Node.js 버전 관리, nvm으로 효율적으로
Node.js를 활용한 개발 과정에서는 여러 프로젝트가 각각 다른 Node.js 버전을 요구하는 경우가 자주 발생합니다. 이는 패키지들이 특정 Node.js 버전에 강한 의존성을 가질 때 흔히 겪는 문제로, 개발 환경의 유연성을 떨어뜨릴 수 있습니다. 이럴 때 nvm(Node Version Manager)이라는 도구가 매우 유용합니다. nvm은 다양한 Node.js 버전을 설치하고 필요에 따라 손쉽게 전환할 수 있게 도와주는 명령어 기반 도구입니다.
nvm(Node Version Manager)이란?
nvm은 개발자가 여러 Node.js 버전을 설치하고 관리하며, 프로젝트에 맞춰 필요한 버전을 신속하게 전환할 수 있도록 지원하는 커맨드라인 인터페이스(CLI) 도구입니다. 예를 들어, 한 프로젝트는 Node.js 16을 기반으로 하고 다른 프로젝트는 Node.js 18을 필요로 할 때, nvm을 사용하면 두 버전을 모두 설치해 놓고 각 프로젝트 작업 시점에 맞춰 해당 버전을 활성화하여 사용할 수 있습니다.
nvm의 주요 장점은 다음과 같습니다:
- 다중 버전 지원: 여러 Node.js 버전을 동시에 설치할 수 있어, 프로젝트별 요구사항을 충족시킵니다.
- 간편한 버전 전환:
nvm use명령어를 통해 원하는 버전으로 빠르게 변경할 수 있습니다. - 기본 버전 설정: 특정 버전을 기본값으로 지정하여 새로운 터미널을 열 때 자동으로 적용되게 할 수 있습니다.
- npm 연동: Node.js 버전 관리에 따라 호환되는 npm(Node Package Manager)도 함께 관리됩니다.
nvm 설치 가이드
nvm은 운영체제에 따라 설치 방법이 약간 다릅니다. Linux와 macOS는 유사한 방식을 사용하며, Windows는 별도의 nvm-windows 프로젝트를 이용해야 합니다.
1. Linux 및 macOS 설치 (추천 방식: curl 또는 wget)
가장 권장되는 방법은 nvm의 공식 GitHub 저장소에서 제공하는 설치 스크립트를 사용하는 것입니다.
- curl 명령어 사용:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash- wget 명령어 사용:
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash설치 후 설정:
설치 스크립트는 nvm을 사용자 홈 디렉토리 내 .nvm 경로에 설치하고, 쉘 설정 파일(예: .bashrc, .zshrc, .profile)에 nvm 로딩 코드를 자동으로 추가합니다. 설치를 완료한 후에는 터미널을 새로 시작하거나, 다음 명령어를 입력하여 쉘 설정을 다시 로드해야 합니다.
source ~/.bashrc # 또는 사용 중인 쉘 설정 파일
설치 확인:
터미널에서 아래 명령어를 실행하여 버전 정보가 출력되면 정상적으로 설치된 것입니다.
nvm --version
2. Windows 설치 (nvm-windows)
Windows 환경에서는 nvm-windows를 사용해야 합니다.
- nvm-windows GitHub 페이지에 접속합니다.
- 최신 안정 버전의
nvm-setup.zip파일을 다운로드합니다. - 압축을 풀고
nvm-setup.exe파일을 실행하여 설치 마법사의 안내에 따릅니다.
설치 확인:
명령 프롬프트 또는 PowerShell을 열고 다음 명령어를 실행하여 버전 정보가 나타나는지 확인합니다.
nvm version
nvm 활용법
nvm의 주요 기능은 간단한 명령어를 통해 실행할 수 있습니다.
1. Node.js 버전 설치
nvm install 18 # Node.js 18의 최신 안정 버전 설치
nvm install 16.20.0 # 특정 버전 설치
nvm install node # 최신 안정 버전 설치
2. 설치된 버전 목록 확인
nvm ls 또는 nvm list 명령어를 사용하여 현재 시스템에 설치된 Node.js 버전을 확인할 수 있습니다.
nvm ls
출력 예시:
v16.20.2
v18.19.1
-> v20.12.2
default -> 20.12.2 (node)
위 예시에서 ->는 현재 사용 중인 버전을 의미합니다.
3. 버전 전환
프로젝트에 필요한 Node.js 버전으로 전환하려면 nvm use 명령어를 사용합니다.
nvm use 18 # 설치된 18.x.x 버전 중 최신 버전으로 전환
nvm use 16.20.0 # 특정 버전으로 전환
4. 기본 버전 설정
새로운 터미널 세션이 시작될 때 자동으로 적용될 Node.js 버전을 설정할 수 있습니다.
nvm alias default 18.19.1 # 18.19.1 버전을 기본값으로 설정
nvm alias default node # 최신 안정 버전을 기본값으로 설정
5. 버전 삭제
더 이상 사용하지 않는 Node.js 버전을 제거하려면 nvm uninstall 명령어를 사용합니다. 현재 활성화된 버전은 삭제할 수 없습니다.
nvm uninstall 16.20.0
6. 설치 가능한 버전 확인
nvm ls-remote 명령어를 사용하여 nvm으로 설치 가능한 모든 Node.js 버전을 확인할 수 있습니다.
마무리
nvm은 여러 Node.js 프로젝트를 관리하는 개발자에게 필수적인 도구입니다. 다양한 버전의 Node.js를 유연하게 설치하고 전환할 수 있어 개발 환경의 효율성을 극대화할 수 있습니다. nvm의 설치와 사용법을 익히면 Node.js 개발 작업이 훨씬 더 편리해질 것입니다.