Node.js 버전 관리를 위한 nvm 설치 및 사용법

1. nvm이란?

• nvm(Node Version Manager)은 여러 버전의 Node.js를 한 시스템에서 쉽게 설치하고 전환할 수 있는 도구입니다.

---

2. 설치 방법 (macOS, Linux)

2-1. nvm 설치

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

2-2. 설치 적용 (터미널 재시작 또는 아래 명령 실행)

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

2-3. 설치 확인

nvm --version

---

3. Node.js 설치 및 사용법

3-1. Node.js 특정 버전 설치

nvm install 20.19.0

3-2. 설치한 버전 사용

nvm use 20.19.0

3-3. 기본 버전 설정

nvm alias default 20.19.0

3-4. 설치된 버전 목록 확인

nvm ls

---

4. Windows 사용자는?

• Windows에서는 nvm-windows(https://github.com/coreybutler/nvm-windows)를 사용해야 합니다.

---

5. 유용한 명령 요약

명령어설명

nvm install <version>	특정 버전 Node.js 설치
nvm use <version>	해당 버전 사용
nvm alias default <version>	기본 Node.js 버전 설정
nvm ls	설치된 Node.js 버전 목록 보기
node -v	현재 사용 중인 Node.js 버전 확인

---

6. 참고

• 공식 문서: https://github.com/nvm-sh/nvm
• nvm은 시스템 전역 설치가 아닌 사용자 디렉토리에 설치됩니다.

---

7. 자주 발생하는 문제

• nvm: command not found 오류 발생 시:
  • 터미널을 재시작하거나 .bashrc, .zshrc에 nvm 초기화 코드가 누락된 경우입니다.
  • 아래 코드를 쉘 설정 파일에 추가하세요:

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

---

이 가이드를 따라 하면 원하는 Node.js 버전을 자유롭게 관리할 수 있습니다.