[Node.js] NVM(Node Version Manager)

NVM(Node Version Manager)

들어가며

• 노드(Node.js) 버전 관리자인 NVM(Node Version Manager)에 대해 간단히 정리해본다.

 

 

NVM(Node Version Manager)

개념

• Node.js 버전을 손쉽게 관리할 수 있는 명령줄(CLI) 도구
• Node.js는 자바스크립트 런타임이기 때문에, 프로젝트마다 다른 버전의 Node.js가 필요할 수 있다.
• 이때 nvm을 사용하면 손쉽게 다음의 기능을 수행할 수 있다.
  
  • 여러 Node.js 버전 설치하기
  • 원하는 Node.js 버전으로 전환하기
  • 프로젝트에 맞는 버전만 사용할 수 있도록 제한하기

 

종류

• nvm의 종류에는 플랫폼에 따라 다음과 같이 2가지가 존재한다.

플랫폼	이름	레포지토리 (설치 방법)
MacOS / Linux	nvm	https://github.com/nvm-sh/nvm
Windows	nvm-windows	https://github.com/coreybutler/nvm-windows

 

주요 명령어

			
			
			
		
# Node 버전 설치
$ nvm install 18
 
# 특정 버전 사용
$ nvm use 18
 
# 기본 버전 설정 (터미널 새로 열었을 때 사용됨)
$ nvm alias default 18
 
# 설치된 버전 목록 확인
$ nvm list
 
# 설치 가능한 Node.js 버전 목록 (공식 서버에서 조회)
$ nvm list available
 
# 설치된 Node.js 버전 제거
$ nvm uninstall 18

 

주의 사항

• nvm use 명령은 현재 터미널 세션에만 적용된다.
• npm도 Node.js와 함께 설치되므로 별도로 설치할 필요는 없다.
• nvm을 쓰기 위해 기존 수동 설치된 Node.js는 제거하는 게 좋다.

 

nvm은 ①프로젝트마다 Node.js 버전이 다르거나, ②오래된 프로젝트를 실행해야할 때, 또는 ③최신 버전 테스트가 필요할 때 사용하면 유용하다.

 

개발 환경 구축하기

Windows

(1) 프로그램 설치하기

• 아래의 링크에서 nvm-setup.exe 파일을 다운로드 받아 실행한다.

Releases · coreybutler/nvm-windows

 

목적에 따른 파일을 다운로드 받아 실행한다.

 

(2) 설치 확인하기

• 아래 명령을 실행하여 설치된 nvm 버전을 확인한다.
• 정상적으로 설치되었다면 설치된 nvm 버전이 표시된다.

			
			
			
		
$ nvm --version   # 또는 nvm -v

 

(참고) Git Bash 셸에 nvm 인식 시키는 방법

• nvm-windows는 기본적으로 cmd나 PowerShell 에서 인식된다.
• 따라서 Git Bash 셸에서는 기본적으로 nvm이 인식되지 않는다.

 

① nvm 경로 확인하기

• 2025년 5월 11일 기준, nvm은 아래의 경로에 설치된다.

			
			
			
		
C:\Users\[사용자명]\AppData\Local\nvm

 

② Git Bash에 환경 변수 추가하기

• ~/.bashrc 파일을 연 후, 아래의 내용을 추가해준다.

			
			
			
		
$ vim ~/.bashrc

 

~/.bashrc

			
			
			
		
# NVM 환경 변수 설정하기
export NVM_HOME="/c/Users/[사용자명]/AppData/Local/nvm"
export NVM_SYMLINK="/c/Program Files/nodejs"
export PATH="$NVM_HOME:$NVM_SYMLINK:$PATH"

 

• 공백이 포함된 경로(/c/Program Files/nvm)는 위처럼 따옴표로 묶어야 한다.
• 현재 PC에 이미 Node.js가 설치되어 있을 경우 두 번째 줄의 코드를 다음과 같이 작성해준다.
  • 이렇게 설정하지 않을 경우, 심볼릭 링크 관련 충돌이 발생한다.
    • 기존의 Node.js는 /c/Program Files/nodejs에 설치되기 때문이다.
  • 심볼릭 링크로 설정할 파일명(nvm-link)은 자신이 원하는 이름으로 설정 가능하다.

			
			
			
		
export NVM_SYMLINK="/c/Program Files/nvm-link"

 

③ 변경 사항 적용하기

			
			
			
		
$ source ~/.bashrc

 

④ 정상 작동하는지 확인하기

			
			
			
		
$ nvm --version   # 또는 nvm -v

 

MacOS / Linux

(1) 설치 스크립트 실행하기

• 터미널에서 아래 명령어를 그대로 입력하여 실행한다.
  
  • v0.40.3 부분에 설치하기를 원하는 nvm 버전을 넣어준다.

			
			
			
		
# 방법 1: curl을 이용하여 설치하기
$ curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
 
# 방법 2 : wget을 이용하여 설치하기
$ wget -q0- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

 

(2) 셸 설정 적용하기

• 설치가 끝나면 아래 명령을 실행하여 셀 설정 파일을 다시 불러온다.

			
			
			
		
$ source ~/.bashrc       # bash 사용 시
$ source ~/.zshrc        # zsh 사용 시
$ source ~/.profile      # 일부 Linux 환경

 

(3) 설치 확인하기

• 아래 명령을 실행하여 설치된 nvm 버전을 확인한다.
• 정상적으로 설치되었다면 설치된 nvm 버전이 표시된다.

			
			
			
		
$ nvm --version   # 또는 nvm -v

 

참고 사항

• 설치된 Node.js는 ~/.nvm/versions/node/ 경로에 저장된다.
• 터미널을 열 때마다 자동으로 nvm이 불러와지도록 .bashrc 또는 .zshrc 파일에 아래의 내용을 추가해줘야 한다.

			
			
			
		
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

 

참고 사이트

GitHub - nvm-sh/nvm: Node Version Manager - POSIX-compliant bash script to manage multiple active node.js versions

GitHub - coreybutler/nvm-windows: A node.js version management utility for Windows. Ironically written in Go.