Ubuntu에서 NVM 설치하고 Node.js 버전 관리하기: 완벽 가이드 (2026년 3월 최신)

여러 Node.js 프로젝트를 동시에 관리하다 보면 프로젝트마다 요구하는 Node.js 버전이 다른 경우가 빈번합니다. 이때 NVM(Node Version Manager)을 사용하면 하나의 시스템에서 여러 Node.js 버전을 손쉽게 설치하고 전환할 수 있습니다. 이 글에서는 Ubuntu 22.04 및 24.04 환경에서 NVM을 설치하고 활용하는 방법을 단계별로 안내합니다.

NVM이란? 왜 필요한가?

NVM은 Node.js 버전을 관리하는 커맨드라인 도구입니다. 기존에는 Node.js 버전을 변경하려면 기존 버전을 제거하고 새로 설치하거나, snap 패키지를 통해 채널을 변경해야 했습니다. NVM을 사용하면 이런 번거로움 없이 한 줄 명령어로 버전을 전환할 수 있습니다.

NVM 설치 방법 (Ubuntu 22.04 / 24.04)

NVM 설치는 공식 GitHub 저장소(github.com/nvm-sh/nvm)에서 제공하는 스크립트를 실행하면 됩니다. curl 또는 wget 중 하나를 선택하여 실행합니다.

curl을 사용한 설치

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

wget을 사용한 설치

wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

설치가 완료되면 터미널을 닫고 다시 열어야 NVM 환경변수가 적용됩니다. 새 터미널을 열거나 다음 명령어를 실행하세요.

source ~/.bashrc

정상 설치 확인은 nvm --version 명령어로 할 수 있습니다. 버전 번호가 출력되면 설치가 완료된 것입니다.

Node.js 버전 설치 및 관리

NVM이 설치되었다면 이제 원하는 Node.js 버전을 자유롭게 설치할 수 있습니다.

설치 가능한 버전 확인

# 설치된 버전 목록 확인
nvm ls

# 원격에서 설치 가능한 전체 버전 목록
nvm ls-remote

특정 버전 설치

# LTS 최신 버전 설치
nvm install --lts

# 특정 버전 설치
nvm install 20.11.0

# 특정 메이저 버전의 최신 설치
nvm install 18

Node.js 버전 전환하기

여러 버전이 설치되어 있다면 nvm use 명령어로 즉시 전환할 수 있습니다.

# 현재 버전 확인
node --version
# v20.11.0

# 다른 버전으로 전환
nvm use 18
# Now using node v18.20.0

# 시스템 기본 Node.js로 전환
nvm use system

# 다시 확인
node --version
# v18.20.0

프로젝트 루트에 .nvmrc 파일을 생성하면 해당 디렉토리에서 자동으로 지정된 버전을 사용할 수 있습니다.

# .nvmrc 파일 생성
echo "20" > .nvmrc

# 해당 디렉토리에서 자동 전환
nvm use

실전 팁과 자주 묻는 질문

마무리

NVM은 Node.js 개발 환경에서 버전 관리의 번거로움을 해결해주는 필수 도구입니다. 설치에 1분도 걸리지 않으며, 한번 익숙해지면 프로젝트마다 버전 호환성 문제로 고민할 일이 사라집니다. Ubuntu 22.04와 24.04 모두에서 동일하게 동작하므로 지금 바로 설치하여 활용해보세요.