nvm 설치 brew macOS 환경에서 Node.js 버전 관리하는 완벽 가이드 및 최신 설치 방법 보기

개발 환경을 구축할 때 Node.js는 필수적인 요소이며, 프로젝트마다 요구하는 Node.js 버전이 다를 수 있습니다. 이럴 때 **Node Version Manager(nvm)**는 여러 Node.js 버전을 손쉽게 전환하고 관리할 수 있도록 돕는 핵심 도구입니다. 특히 macOS 사용자라면 패키지 관리자인 Homebrew(brew)를 사용하여 nvm을 설치하는 것이 일반적입니다.

이 가이드에서는 macOS 환경에서 Homebrew를 이용해 nvm을 설치하는 가장 확실한 방법과 함께, nvm을 활용한 Node.js 버전 관리법까지 2025년 최신 정보로 업데이트하여 상세하게 안내합니다. 2024년에도 많은 개발자들이 사용했던 기본적인 설치 방식에서 발생할 수 있는 잠재적인 이슈 해결 방법까지 포함하고 있으니, Node.js 개발 환경을 깔끔하게 구축하려는 분들에게 큰 도움이 될 것입니다.

Homebrew를 통해 nvm을 설치하는 것은 간편하지만, 설치 후 환경 변수 설정이나 PATH 경로 설정에서 실수를 하거나 잘못된 정보를 따라 할 경우 nvm 명령어를 찾지 못하는 오류를 겪을 수 있습니다. 따라서 이 포스팅의 단계별 지침을 정확하게 따라하는 것이 중요합니다. 성공적인 Node.js 개발 환경 구축의 첫 걸음을 시작해 보세요.

nvm 설치 brew 시작하기 Homebrew를 이용한 nvm 설치 준비 확인하기

nvm을 설치하기에 앞서, macOS 환경에서 가장 먼저 확인해야 할 것은 패키지 관리 도구인 Homebrew가 정상적으로 설치되어 있는지 여부입니다. Homebrew는 macOS에서 필요한 다양한 개발 도구와 라이브러리를 설치하고 관리하는 데 사용됩니다.

Homebrew(brew) 설치 상태 확인 상세 더보기

터미널(Terminal)을 열고 다음 명령어를 입력하여 Homebrew의 설치 여부를 확인합니다. 이미 설치되어 있다면 버전 정보가 출력됩니다. 만약 설치되어 있지 않다면, Homebrew 공식 웹사이트에서 제공하는 설치 명령어를 사용하여 먼저 Homebrew를 설치해야 합니다.

brew --version

기존 nvm 설치 확인 및 제거 보기

이전에 nvm을 다른 방법(예: curl 또는 wget 스크립트)으로 설치한 적이 있다면, Homebrew 설치 전에 충돌을 방지하기 위해 기존 설치된 nvm을 제거하는 것이 좋습니다. Homebrew를 통해 설치하는 것이 nvm 공식 저장소에서도 권장하는 최신 방법은 아니지만, macOS 사용 환경의 통일성을 위해 Homebrew를 선호하는 경우가 많습니다. 단, 공식 문서에서는 Homebrew를 통한 설치를 권장하지 않으며 스크립트를 통한 설치를 권장한다는 점을 참고하세요. 이 포스팅은 Homebrew를 사용하여 설치하는 방법을 찾는 사용자를 위해 작성되었습니다.

기존 nvm 설치가 의심된다면, 관련된 환경 변수 설정이나 스크립트 파일을 찾아 제거해야 합니다.

Homebrew를 이용한 nvm 설치 및 환경 변수 설정 확인하기

Homebrew가 준비되었다면, 다음 단계를 따라 nvm을 설치하고 환경 변수를 설정하여 터미널에서 nvm 명령어를 인식할 수 있도록 합니다. 이 과정은 2025년 현재 macOS에서 nvm을 안정적으로 사용하는 데 있어 매우 중요합니다.

brew install nvm 명령으로 설치 상세 더보기

터미널에서 다음 명령어를 입력하여 nvm을 설치합니다. Homebrew가 nvm 패키지를 다운로드하고 시스템에 설치합니다.

brew install nvm

설치가 완료되면 Homebrew는 nvm이 설치된 경로를 안내합니다. 일반적으로 이 경로는 /usr/local/opt/nvm 또는 M1/M2 칩 기반 Mac의 경우 /opt/homebrew/opt/nvm 경로에 위치합니다.

환경 변수 설정 (PATH) 확인하기

nvm 설치 후에도 터미널에서 nvm 명령어를 바로 사용할 수 없는 경우가 있습니다. 이는 nvm이 설치된 경로가 셸(Shell)의 PATH 환경 변수에 추가되지 않았기 때문입니다. 사용하는 셸(Bash, Zsh 등)에 맞게 설정 파일을 수정해야 합니다.

대부분의 최신 macOS는 Zsh를 기본 셸로 사용하므로, ~/.zshrc 파일을 수정해야 합니다. Bash를 사용하는 경우 ~/.bash_profile 또는 ~/.bashrc 파일을 수정합니다.

다음 내용을 셸 설정 파일(예: ~/.zshrc)에 추가합니다. 경로가 Homebrew가 안내한 경로와 일치하는지 확인하세요. (brew --prefix nvm) 명령어를 사용하면 설치된 정확한 경로를 얻을 수 있습니다.

export
NVM_DIR="HOME/.nvm" [ -s "(brew --prefix nvm)/nvm.sh" ] && . "(brew --prefix nvm)/nvm.sh" # This loads nvm [ -s "(brew --prefix nvm)/etc/bash_completion.d/nvm" ] && . "$(brew --prefix nvm)/etc/bash_completion.d/nvm" # This loads nvm bash_completion

설정 파일 적용 및 nvm 설치 확인 상세 더보기

설정 파일을 저장한 후, 다음 명령어를 사용하여 변경 사항을 현재 터미널 세션에 적용합니다. 또는 단순히 터미널 창을 닫았다가 다시 열어도 됩니다.

source ~/.zshrc # Zsh 사용자 source ~/.bash_profile # Bash 사용자

마지막으로, 다음 명령어를 입력하여 nvm이 정상적으로 설치되고 인식되는지 확인합니다. 버전 정보가 출력되면 성공입니다.

nvm --version

nvm nodejs 버전 관리 핵심 사용법 및 명령어 확인하기

nvm 설치가 완료되었다면, 이제 nvm의 가장 중요한 기능인 Node.js 버전 관리를 시작할 수 있습니다. 프로젝트 요구 사항에 따라 여러 버전을 설치하고, 필요할 때마다 손쉽게 전환하는 방법을 알아봅니다.

Node.js 버전 설치 상세 더보기

원하는 Node.js 버전을 설치하려면 nvm install 명령어를 사용합니다. 특정 버전을 지정하거나, 최신 안정화 버전(LTS) 또는 최신 버전을 설치할 수 있습니다.

• 특정 버전 설치 (예: 18.17.1): nvm install 18.17.1
• 최신 안정화 버전 (LTS) 설치: nvm install --lts
• 가장 최신 버전 설치: nvm install node

설치된 버전 확인 및 사용 보기

설치된 Node.js 버전 목록을 확인하려면 다음 명령어를 사용합니다.

nvm ls

설치된 버전 중에서 특정 버전을 사용하려면 nvm use 명령어를 사용합니다.

nvm use 18.17.1

이 명령어는 현재 터미널 세션에만 해당 Node.js 버전을 적용합니다. 새 터미널을 열면 기본 버전으로 돌아갈 수 있습니다.

기본 버전 설정 확인하기

새로운 터미널을 열 때마다 자동으로 사용하고 싶은 Node.js 버전을 설정하려면 nvm alias default 명령어를 사용합니다. 이렇게 설정된 버전은 이후 새 터미널 세션에서 기본적으로 로드됩니다.

nvm alias default 18.17.1

brew nvm 설치 오류 해결 및 추가 팁 확인하기

Homebrew를 통해 nvm을 설치할 때 발생할 수 있는 일반적인 오류와 이를 해결하는 방법을 안내합니다. 특히 PATH 설정 오류는 초보자가 가장 많이 겪는 문제이므로 주의 깊게 확인해야 합니다.

nvm: command not found 오류 해결 상세 더보기

이 오류는 nvm 설치가 완료되었음에도 터미널 셸이 nvm 명령어를 찾지 못할 때 발생합니다. 대부분 앞서 설명한 환경 변수(PATH) 설정이 누락되었거나 잘못되었기 때문입니다.

1. 사용하는 셸(Zsh, Bash)의 설정 파일(~/.zshrc 또는 ~/.bash_profile)에 nvm 로딩 스크립트가 정확히 추가되었는지 확인합니다.
2. 설정 파일에 변경 사항을 적용하기 위해 source 명령어를 실행했는지 확인합니다.
3. Homebrew의 설치 경로(/usr/local/opt/nvm 또는 /opt/homebrew/opt/nvm)가 설정 파일의 경로와 일치하는지 다시 확인합니다.

만약 계속 문제가 발생한다면, Homebrew를 통한 설치를 제거하고 nvm 공식 GitHub에서 권장하는 스크립트 설치 방법을 시도해 보는 것도 좋은 대안입니다. 이 방법은 Homebrew 의존성 없이 nvm을 설치합니다.

npm 전역 패키지 마이그레이션 보기

새로운 Node.js 버전을 설치한 후, 이전에 사용하던 버전에서 설치했던 전역 npm 패키지(예: npm install -g )를 새 버전으로 가져오고 싶을 수 있습니다. nvm은 이 과정을 위한 유용한 기능을 제공합니다.

nvm install 20 --reinstall-packages-from=18.17.1

위 명령은 Node.js 20 버전을 설치하면서, 이전에 18.17.1 버전에서 설치했던 모든 전역 패키지를 자동으로 재설치하여 마이그레이션합니다.

Node.js 제거 확인하기

더 이상 사용하지 않는 Node.js 버전을 제거하여 디스크 공간을 확보할 수 있습니다. nvm uninstall 명령어를 사용합니다.

nvm uninstall 16.14.0

제거하기 전에 해당 버전이 기본(default) 버전이나 현재 사용(current) 중인 버전이 아닌지 확인해야 합니다.

이 가이드를 통해 macOS 사용자들이 Homebrew를 이용해 nvm을 설치하고 Node.js 버전을 효과적으로 관리하는 데 필요한 모든 정보를 얻으셨기를 바랍니다. 안정적인 개발 환경은 효율적인 코딩의 기반이 됩니다.

---

nvm 설치 및 Node.js 버전 관리에 대한 FAQ 상세 더보기