Mac 개발 환경에서 Node.js 버전을 효율적으로 관리하는 것은 필수입니다. 프로젝트마다 요구되는 Node.js 버전이 다를 수 있으며, 이를 손쉽게 전환할 수 있게 해주는 도구가 바로 NVM(Node Version Manager)입니다. 이 가이드는 최신 Mac 운영체제(Apple Silicon 포함)와 기본 쉘인 ZSH 환경에서 NVM을 성공적으로 설치하고 설정하는 2025년 최신 방법을 상세하게 안내합니다. 잘못된 설정으로 인해 발생하는 문제를 방지하고, 개발 효율성을 극대화하는 방법을 확인해보세요.
📚 함께 읽으면 좋은 글
⭐ Mac NVM 설치 전 필수 준비사항 확인하기
NVM을 설치하기 전에 몇 가지 필수적인 준비 사항을 확인해야 합니다. 특히 Apple Silicon(M1, M2 등) 칩셋을 사용하는 Mac 사용자라면, 호환성 문제를 피하기 위해 다음 사항을 반드시 체크해야 합니다.
✅ Homebrew 설치 여부와 ZSH 쉘 설정 보기
대부분의 Mac 사용자는 패키지 관리자로 Homebrew를 사용하지만, NVM은 공식적으로 Homebrew를 통한 설치를 권장하지 않습니다. Homebrew를 통해 설치할 경우 환경 변수 설정이나 버전 관리에서 예기치 않은 충돌이 발생할 수 있기 때문입니다. 대신, 공식 설치 스크립트(cURL 또는 Wget)를 사용할 것을 권장합니다. 현재 사용 중인 쉘이 ZSH인지 확인하는 것도 중요합니다. 터미널을 열고 다음 명령어를 입력하여 확인합니다.
echo $SHELL결과가 /bin/zsh라면 ZSH 쉘을 사용 중인 것입니다. 만약 다른 쉘이라면 (예: /bin/bash), chsh -s /bin/zsh 명령을 사용하여 변경할 수 있습니다. NVM은 설치 후 ZSH 환경 설정 파일에 자동으로 필요한 스크립트를 추가합니다.
NVM 공식 GitHub 저장소를 통해 최신 설치 스크립트를 확인하는 것이 가장 안전합니다.
🚀 ZSH 환경에서 NVM 설치 스크립트 실행 상세 더보기
NVM을 설치하는 가장 권장되는 방법은 공식 설치 스크립트를 사용하는 것입니다. 이 방법은 Homebrew를 사용할 때 발생할 수 있는 잠재적인 환경 변수 충돌 문제를 피할 수 있게 해줍니다.
✅ cURL 또는 Wget을 사용한 NVM 설치 명령어 확인하기
터미널에서 다음 명령어 중 하나를 사용하여 NVM을 설치합니다. 이 명령어는 최신 버전의 NVM 소스를 다운로드하고, 사용자의 홈 디렉토리에 숨김 폴더(.nvm)를 생성한 뒤, 필요한 환경 변수를 자동으로 설정 파일에 추가합니다.
cURL 사용:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bashWget 사용:
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash설치 스크립트 실행 후, NVM이 제대로 로드되도록 터미널을 다시 시작하거나 다음 명령어를 실행하여 ZSH 설정을 다시 로드해야 합니다:
source ~/.zshrcNVM이 올바르게 설치되었는지 확인하려면 다음 명령어를 입력합니다. 버전 정보가 출력되면 성공입니다.
nvm --version💻 Mac ZSH 환경 파일에 NVM 자동 로드 설정 보기
NVM 설치 스크립트는 일반적으로 환경 변수를 자동으로 설정해줍니다. ZSH를 사용하는 Mac 환경에서는 주로 ~/.zshrc 파일에 설정이 추가됩니다. 만약 설치 후에도 NVM 명령어를 인식하지 못한다면, 직접 해당 파일을 확인하고 설정을 추가해야 합니다.
✅ .zshrc 파일에 NVM 로드 스크립트 추가하기
텍스트 편집기를 사용하여 ~/.zshrc 파일을 엽니다:
nano ~/.zshrc파일의 가장 아래쪽에 다음과 같은 코드가 추가되어 있는지 확인합니다. 코드가 없다면 직접 추가합니다.
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파일을 저장하고 닫은 후, source ~/.zshrc 명령으로 설정을 다시 로드하면 NVM을 사용할 준비가 완료됩니다. 이 설정은 Mac을 재시작하거나 새 터미널 창을 열 때마다 NVM을 자동으로 로드하여 Node.js 버전 관리를 가능하게 합니다.
🔄 NVM을 이용한 Node.js 버전 설치 및 관리 확인하기
NVM 설치가 완료되었다면, 이제 Node.js 버전을 자유롭게 설치하고 전환할 수 있습니다. NVM의 강력한 버전 관리 기능을 활용하여 프로젝트 요구 사항에 맞는 환경을 구축해보세요.
✅ Node.js 최신 버전과 특정 버전 설치 및 사용하기
현재 사용 가능한 Node.js 버전을 확인하려면 다음 명령어를 사용합니다:
nvm ls-remote특정 버전의 Node.js를 설치하려면 nvm install [버전] 명령어를 사용합니다. 예를 들어, 최신 LTS(Long Term Support) 버전을 설치하려면:
nvm install --lts특정 버전(예: Node.js 18.x)을 설치하려면:
nvm install 18설치된 Node.js 버전 목록을 확인하려면:
nvm ls사용할 버전을 전환하려면:
nvm use 18새 터미널을 열 때마다 특정 버전이 기본적으로 사용되도록 설정하려면:
nvm alias default 18이 기능을 통해 개발자는 여러 프로젝트를 동시에 진행하면서도 각 프로젝트에 맞는 Node.js 환경을 쉽고 빠르게 구성할 수 있습니다. 2025년 개발 환경에서는 다양한 버전의 Node.js를 동시에 관리하는 것이 일반적이므로, NVM은 Mac 사용자에게 필수적인 도구입니다.
📌 추가로 참고할 만한 글
❓ 자주 묻는 질문 (FAQ)
| 질문 | 답변 |
|---|---|
| Q1. NVM 설치 후 "command not found" 오류가 발생합니다. | 이는 주로 NVM 환경 변수가 ZSH 쉘에 제대로 로드되지 않았기 때문입니다. ~/.zshrc 파일에 NVM 로드 스크립트가 정확하게 추가되었는지 확인하고, source ~/.zshrc 명령을 실행하거나 터미널을 완전히 재시작해야 합니다. |
| Q2. Homebrew로 NVM을 설치하면 왜 문제가 될 수 있나요? | Homebrew는 Node.js도 직접 관리할 수 있어, NVM이 설치하는 Node.js 경로와 충돌할 가능성이 있습니다. 공식 설치 스크립트를 사용하여 설치하는 것이 NVM의 기능(버전 전환 등)을 가장 안정적으로 사용할 수 있는 방법입니다. |
| Q3. Apple Silicon (M1/M2) Mac에서도 NVM 설치 방법이 동일한가요? | 네, NVM은 Apple Silicon 환경에서도 공식 스크립트 설치 방법을 사용하면 문제없이 작동합니다. NVM이 설치하는 Node.js 버전은 Apple Silicon에 최적화된 아키텍처를 자동으로 사용합니다. |
| Q4. 설치한 모든 Node.js 버전에서 전역 패키지를 공유할 수 있나요? | 아니요, NVM은 각 Node.js 버전을 독립적인 환경으로 관리하기 때문에, 전역 패키지(global packages)는 버전별로 따로 설치해야 합니다. 이는 버전 간의 종속성 충돌을 방지하는 NVM의 핵심 기능입니다. |
이 가이드가 Mac ZSH 환경에서 NVM을 성공적으로 설치하고 Node.js 버전을 관리하는 데 도움이 되기를 바랍니다. 안정적인 개발 환경 구축은 프로젝트 성공의 첫걸음입니다.
본 포스팅은 2025년 12월 최신 정보를 반영하여 작성되었으며, NVM 및 Node.js의 공식 문서와 설치 절차를 기반으로 합니다.
NVM 기본 사용법 및 심화 기능 가이드 바로가기 ZSH 쉘 Powerlevel10k 테마 설정 방법 확인하기