1. NVM(Node Version Manager) 설치

brew install nvm

Zsh 설정 추가

~/.zshrc에 아래 내용 추가:

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

적용:

source ~/.zshrc

2. Node.js 버전 설치 및 전환

버전 설치

nvm install 18
nvm install 20
nvm install 22

버전 사용

nvm use 20

기본 버전 설정

nvm alias default 20

3. 프로젝트별 .nvmrc 파일 생성

프로젝트 폴더 내부에 .nvmrc 파일을 만들고, 사용할 Node 버전을 한 줄만 입력.

예시:

20

혹은 정확한 버전:

v20.11.1

숨김파일 보이기

  • macOS Finder: Cmd + Shift + .
  • VSCode: Explorer 상단 … → Show Hidden Files

4. .nvmrc 파일 만드는 방법

VSCode에서 생성

  1. 프로젝트 폴더에서 New File
  2. 파일명: .nvmrc
  3. 내용 입력 후 저장

터미널에서 생성

echo "20" > .nvmrc

5. .nvmrc 적용

프로젝트 폴더에서:

nvm use
node -v

출력 예:

Found '.nvmrc' with version <20>
Now using node v20.x.x

6. 자동 전환 설정(선택사항)

~/.zshrc에 아래 추가:

autoload -U add-zsh-hook

load-nvmrc() {
  local node_version
  local nvmrc_path

  nvmrc_path="$(nvm_find_nvmrc)"

  if [ -n "$nvmrc_path" ]; then
    node_version=$(cat "$nvmrc_path")
    if [ "$node_version" != "$(node -v 2>/dev/null)" ]; then
      nvm use >/dev/null
      echo "Using Node $(cat "$nvmrc_path") for $(pwd)"
    fi
  fi
}

add-zsh-hook chpwd load-nvmrc
load-nvmrc

적용:

source ~/.zshrc

7. 추천 Node.js 버전

목적 추천 버전

React / Vite 20 / 22 Next.js 20 Node 서버 18 / 20 NAS Docker 18

8. VSCode에서 적용 확인

nvm use
node -v

9. 요약

  • .nvmrc는 프로젝트별 Node 버전 지정 파일
  • 버전만 적으면 됨 (20 또는 v20.11.1)
  • nvm use로 적용
  • 자동 전환도 가능
  • VSCode / Docker / NAS 모두 호환됨