[WEB][Node.js] Node.js 설치 및 NVM을 이용한 버전 관리 (feat. nvm-windows)

이 글은 윈도우 환경에서 NVM을 이용하여 node.js를 설치하고, 여러 버전을 관리하는 방법에 대해서 정리한 글입니다.

기본적으로 NVM은 Linux와 MacOS용으로 개발되어 Windows에서는 공식 NVM을 사용할 수 없습니다. 그래서 Windows 사용자는 nvm-windows라는 별도의 프로젝트를 사용하여 Node.js의 버전을 관리하게 됩니다. 이번 글에서도 nvm-windows를 설치하고, nvm-windows를 이용하여 Node.js를 설치하고 버전 관리 하는 방법에 대해 정리하였습니다.

---

NVM (Node.js Version Manager)

• NVM은 Node.js 버전 관리 도구
• 여러 버전의 Node.js를 설치하고, 원하는 버전으로 전환할 수 있도록 도와주는 도구

Anaconda(or miniconda)나 pyenv를 사용하여 Python의 다양한 버전을 관리하는 것과 같이, NVM은 다양한 버전의 Node.js를 관리하는 도구라고 이해하면 된다.

NVM의 주요 기능

• Node.js의 다양한 버전 설치 및 삭제
• 프로젝트 별로 서로 다른 Node.js 버전 사용 가능
• 빠른 버전 전환 명령어 제공

NVM의 주요 명령어

MacOS / Linux 기준	nvm-windows 기준	설명
nvm install <version>	nvm install <version>	해당 버전 설치
nvm use <version>	nvm use <version>	해당 버전으로 전환
nvm ls	nvm list or nvm ls	설치된 Node.js 버전 목록 확인
nvm uninstall <version>	nvm uninstall <version>	해당 버전 삭제
nvm current	-	현재 사용 중인 Node.js 버전 표시

---

NVM for Windows 설치

NVM for windows(nvm-windows, 이하 NVM)과 Node.js를 개별로 설치하면 충돌이 발생할 수 있습니다. 만약 NVM을 설치하기 전에 Node.js가 설치되어 있다면 반드시 삭제하고 진행해야 합니다. (터미널 혹은 PowerShell에서 node -v 명령어를 입력하면 설치된 버전을 확인할 수 있으며, 만약 버전이 출력되면 Node.js가 설치되어 있는 상태이므로 설치 전에 삭제를 진행하시면 됩니다.)

본격적으로 NVM 설치를 진행해보자.

 

아래 링크에서 NVM for Windows 설치 파일을 다운받는다. 여러 파일 들 중에서 nvm-setup.zip 혹은 nvm-setup.exe 파일을 받으면 된다. (글을 작성하는 시점인 25.03.06. 기준으로 최신 버전은 1.2.2 이다.

https://github.com/coreybutler/nvm-windows/releases

Releases · coreybutler/nvm-windows

다운받은 설치 파일을 실행하여 설치를 진행한다. 설치 과정은 특별한 게 없으므로 생략한다. (빠르게 설치가 완료된다.)

NVM for Windows 설치 진행 과정

설치가 완료되면, 터미널(혹은 PowerShell)을 열고, nvm -v 명령어를 입력하여 설치가 정상적으로 진행되었는지 확인한다.

nvm -v

만약 위 이미지와 같이 설치된 NVM 버전이 아닌 오류가 출력된다면, 터미널을 재실행한 후 명령어를 입력해보고, 그래도 안된다면 컴퓨터를 재부팅한 후 다시 확인 혹은 재설치를 진행하면 해결될 것이다.

---

Node.js 설치

NVM 설치를 완료하였으니, NVM을 이용하여 Node.js의 설치를 진행해보자. (Node.js 홈페이지에서 설치 파일을 받는 것이 아니라 NVM의 명령어를 이용하여 설치를 진행하는 것입니다.)

 

터미널(혹은 PowerShell)을 열고, nvm ls available 명령어를 입력하면 아래와 같이 설치할 수 있는 Node.js 버전을 확인할 수 있다.

nvm ls available

NVM을 이용하여 설치 가능한 Node.js 리스트 중 일부

만약 더 많은 리스트를 확인하고 싶다면, 아래 홈페이지에서 확인이 가능하다. (Node.js 홈페이지에서 확인 가능한 모든 버전은 NVM을 이용하여 설치가 가능하다고 보면 된다.)

https://nodejs.org/en/about/previous-releases

Node.js — Node.js Releases

이 중에서 원하는 버전을 골라 설치를 진행하면 된다. 설치는 아래 명령어 중 하나를 선택하여 설치하면 된다.

• nvm install lts : LTS 버전 중 최신버전 설치 (25.03.06. 기준으로 가장 최신 LTS 버전인 22.14.0 버전이 설치됨)
• nvm install node : 가장 최신 버전 설치 (25.03.06. 기준으로 가장 최신 버전인 23.9.0 버전이 설치됨)
• nvm install <version> : 선택한 Node.js 버전이 설치됨

명령어를 이용하여 Node.js 설치가 완료되었다면, nvm list 명령어를 통해 현재 컴퓨터에 설치되어 있는 Node.js 버전을 확인할 수 있다.

nvm list

이렇게 설치된 Node.js 버전 중 사용할 버전은 nvm use <version> 명령어를 이용하여 전환할 수 있으며, 현재 사용 중인 Node.js 버전은 리스트를 확인하였을 때 버전 옆에 *이 표시된다.

---

요약 및 정리

• NVM은 여러 Node.js 버전을 설치하고, 관리하기 위한 도구(프로그램)이다.
• NVM은 Linux 및 MacOS용으로 개발되었으며, Windows에서는 nvm-windows라는 프로그램을 이용한다.
• nvm-windows를 설치한 후, nvm 명령어를 이용하여 Node.js 설치 순서로 진행하면 된다. Node.js를 먼저 설치하면 NVM과 충돌이 일어나 문제가 발생할 수 있으므로, 만약 Node.js가 설치되어 있다면 먼저 삭제를 진행한 후 NVM 먼저 설치를 진행해야 한다.