macOS에서 anyenv로 nodenv 설치하고 Node.js 버전 관리하기

macOS에서 Homebrew로 anyenv를 설치한 뒤, nodenv로 Node.js 버전을 관리하는 방법이다.

anyenv 설치와 셸 설정

brew install anyenv
anyenv install --init

anyenv install --init에서 설치 목록 저장소를 내려받을지 물으면 y를 입력한다. 이미 초기화했다면 다시 실행할 필요가 없다.

사용하는 셸의 설정 파일 하나에 다음 줄을 추가한다.

• Zsh: ~/.zshrc
• Bash: ~/.bashrc (환경에 따라 ~/.bash_profile)

eval "$(anyenv init -)"

또는

echo 'eval "\$(anyenv init -)"' >> ~/.zshrc

echo 'eval "\$(anyenv init -)"' >> ~/.bashrc

설정 파일을 저장한 뒤 터미널을 다시 열거나 셸을 재시작한다.

exec "$SHELL" -l

nodenv 설치와 확인

anyenv install nodenv
exec "$SHELL" -l
nodenv --version

nodenv install 명령은 node-build 플러그인이 제공한다. 다음 단계에서 해당 명령을 찾을 수 없다면 플러그인을 설치한다.

git clone https://github.com/nodenv/node-build.git "$(nodenv root)/plugins/node-build"

Node.js 설치와 버전 선택

# 설치 가능한 최신 안정 버전 목록 확인
nodenv install -l

# 목록에서 고른 버전 설치 (아래 버전은 예시)
nodenv install 24.12.0

# 기본 버전 지정
nodenv global 24.12.0

# 적용된 버전 확인
node --version
nodenv version

프로젝트마다 다른 버전을 쓰려면 해당 프로젝트 디렉터리에서 nodenv local <버전>을 실행한다. 이 명령은 현재 디렉터리에 .node-version 파일을 만든다.

cd my-project
nodenv local 24.12.0
node --version

설치한 버전 전체는 nodenv versions로 확인한다. nodenv install -l 목록에 원하는 버전이 없으면 node-build 업데이트 방법을 확인한다.

nodenv 최신화

anyenv로 설치한 nodenv와 node-build 플러그인은 각각 Git으로 업데이트한다. 설치 가능한 Node.js 버전 목록이 오래되었다면 node-build도 업데이트한다.

git -C "$(nodenv root)" pull
git -C "$(nodenv root)/plugins/node-build" pull

참고 문서

• anyenv 공식 README
• nodenv 공식 README
• node-build 공식 README