[Node.js] macOS에서 nvm 설치

macOS에 nvm(Node Version Manager) 설치 및 node 버전 관리 방법

nvm은 node.js의 여러 버전을 쉽게 설치하고 관리할 수 있도록 도와주는 유틸리티이다.

1. nvm 설치

nvm은 Homebrew를 통해 설치하는 것이 가장 간편하다. Homebrew가 설치되어 있지 않다면 다음 명령어를 터미널에 입력하여 설치한다.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Homebrew가 설치되었다면 다음 명령어를 입력하여 nvm을 설치한다.

brew install nvm

2. 환경변수 설정

nvm을 사용하기 위해서는 몇 가지 환경변수를 설정해야 한다. 터미널을 열고 다음 명령어를 입력하여 .zshrc 파일을 연다. (bash를 사용하는 경우 .bashrc 파일을 연다.) 만약 현재 사용 중인 셀이 어떤 것인지 알 수 없다면 echo $SHELL 명령어를 입력하면 확인할 수 있다.

vi ~/.zshrc

.zshrc 파일에 다음 내용을 추가하고 저장해야 하는데, 이 내용은 공식 문서(https://github.com/nvm-sh/nvm?tab=readme-ov-file#troubleshooting-on-macos)에 나와 있는 예제이다.

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

나의 경우 위 내용을 그대로 복붙해서 적용한 후 nvm을 실행하면 nvm을 찾지 못하여 실행되지 않았다. 나와 같은 증상을 겪는다면 아래 명령어를 실행하여 nvm이 설치된 정확한 경로를 확인해야 한다.

brew info nvm

위 명령어를 실행하면 아래의 내용이 포함된 출력을 확인할 수 있다.

You should create NVM's working directory if it doesn't exist:
  mkdir ~/.nvm

Add the following to your shell profile e.g. ~/.profile or ~/.zshrc:
  export NVM_DIR="$HOME/.nvm"
  [ -s "/opt/homebrew/opt/nvm/nvm.sh" ] && \. "/opt/homebrew/opt/nvm/nvm.sh"  # This loads nvm
  [ -s "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm" ] && \. "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm"  # This loads nvm bash_completion

위 출력의 지시 사항을 참고하여, 홈 디렉토리에서 아래 명령어로 .nvm 폴더를 생성한다.

mkdir ~/.nvm

그러고 난 후 .zshrc 파일에 아래 내용을 추가한다. 공식 문서의 경우 경로가 $NVM_DIR로 시작하는데 여기에서는 /opt/homebrew/opt/nvm이다(각자의 환경에 따라 다를 수 있음).

export NVM_DIR="$HOME/.nvm"
  [ -s "/opt/homebrew/opt/nvm/nvm.sh" ] && \. "/opt/homebrew/opt/nvm/nvm.sh"  # This loads nvm
  [ -s "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm" ] && \. "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm"  # This loads nvm bash_completion

3. nvm 적용

.zshrc 파일을 수정했으면 다음 명령어를 입력하여 변경 사항을 적용한다.

source ~/.zshrc

4. nvm 설치 확인

nvm이 제대로 설치되었는지 확인하기 위해 다음 명령어를 입력한다.

nvm --version

nvm 버전이 출력되면 정상적으로 설치된 것입니다.

5. node.js 설치 및 관리

nvm을 사용하여 node.js를 설치하고 관리하는 방법은 다음과 같다.

• node.js 버전 목록 확인: nvm ls-remote
• node.js 설치: nvm install <version> (예: nvm install v16.14.2)
• node.js 버전 변경: nvm use <version> (예: nvm use v16.14.2)
• 설치된 node.js 버전 확인: nvm ls
• 현재 사용 중인 node.js 버전 확인: node -v

✔︎팁

• 특정 프로젝트에서 사용하는 node.js 버전을 지정하고 싶다면 프로젝트 디렉토리에 .nvmrc 파일을 만들고 원하는 node.js 버전을 입력하면 된다.
• nvm 관련 명령어는 nvm --help를 통해 확인할 수 있다.
• macOS Monterey 버전 이후부터는 zsh가 기본 쉘로 설정되어 있다. bash를 사용하는 경우 .bashrc 파일을 수정해야 한다.