Mac 환경에서 Node.js를 설치하고 관리하는 것은 웹 개발을 시작하는 데 있어 필수적인 과정입니다. 특히 M1, M2와 같은 Apple Silicon 칩을 사용하는 최신 Mac 사용자들은 호환성 문제 없이 가장 효율적인 방법으로 설치해야 합니다. 2025년 현재, Node.js를 설치하는 가장 권장되는 방법은 버전 관리자(NVM)를 사용하는 것입니다. 이 가이드는 Homebrew를 이용해 NVM을 설치하고, 이를 통해 원하는 Node.js 버전을 손쉽게 설치 및 관리하는 전체 과정을 상세히 다룹니다.
📚 함께 읽으면 좋은 글
✔️ Mac Node.js 설치 전 준비 사항 Homebrew 확인하기
Node.js 설치를 시작하기 전에 시스템에 필요한 도구들이 설치되어 있는지 확인해야 합니다. 가장 먼저 필요한 것은 macOS에서 패키지 관리를 쉽게 해주는 Homebrew입니다. Homebrew는 Mac용 패키지 관리자로, NVM(Node Version Manager)을 설치할 때 유용하게 사용됩니다.
Homebrew가 설치되어 있지 않다면, 터미널을 열고 다음 명령어를 입력하여 설치할 수 있습니다.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"설치 후, 다음 명령어로 Homebrew가 정상적으로 작동하는지 확인합니다.
brew --version만약 Homebrew 설치에 어려움이 있거나 공식 문서가 필요하다면 아래 버튼을 통해 자세한 내용을 확인할 수 있습니다.
✨ Homebrew를 이용한 NVM(Node Version Manager) 설치 방법 상세 더보기
Node.js를 설치하는 데 가장 권장되는 방식인 NVM은 다양한 프로젝트에서 각기 다른 버전의 Node.js가 필요할 때 버전 전환을 매우 쉽게 해줍니다. Homebrew를 사용하여 NVM을 설치하는 과정은 다음과 같습니다.
NVM 설치 명령어
터미널에서 다음 명령어를 실행하여 NVM을 설치합니다. Homebrew는 자동으로 Apple Silicon(M1/M2) 환경을 인식하고 적절하게 설치를 진행합니다.
brew install nvmNVM 환경 변수 설정
NVM을 설치했더라도, 시스템이 NVM 명령어를 인식하고 Node.js 버전을 관리할 수 있도록 환경 변수를 설정해야 합니다. 사용하고 있는 셸(Shell)에 따라 설정 파일이 다릅니다. 일반적으로 macOS에서 많이 사용하는 셸은 Zsh 또는 Bash입니다.
- Zsh 사용자 (기본 셸):
~/.zshrc파일 수정 - Bash 사용자:
~/.bash_profile또는~/.bashrc파일 수정
다음 내용을 해당 파일의 맨 끝에 추가합니다.
export NVM_DIR="HOME/.nvm" [ -s "(brew --prefix)/opt/nvm/nvm.sh" ] && . "(brew --prefix)/opt/nvm/nvm.sh" # This loads nvm [ -s "(brew --prefix)/opt/nvm/bash_completion" ] && . "$(brew --prefix)/opt/nvm/bash_completion" # This loads nvm bash_completion파일을 수정한 후, 터미널을 재시작하거나 다음 명령어를 실행하여 변경 사항을 적용합니다.
source ~/.zshrc참고: ~/.zshrc는 Zsh 사용자의 예시이며, 사용하는 셸에 맞게 파일명을 변경해야 합니다.
💡 NVM을 이용한 Node.js 설치 및 버전 관리 보기
NVM의 환경 설정이 완료되었다면, 이제 Node.js의 다양한 버전을 손쉽게 설치하고 전환할 수 있습니다. NVM 사용법은 매우 직관적입니다.
사용 가능한 Node.js 버전 확인
설치 가능한 모든 Node.js 버전을 확인합니다.
nvm ls-remote특정 Node.js 버전 설치
일반적으로 LTS(Long Term Support, 장기 지원) 버전을 설치하는 것이 안정적입니다. LTS 버전 중 최신 버전을 설치하려면 다음 명령어를 사용합니다.
nvm install --lts특정 버전을 설치하려면 버전 번호를 지정합니다. 예를 들어, 18.x 버전을 설치하려면 다음과 같이 입력합니다.
nvm install 18설치된 Node.js 버전 확인 및 사용
현재 시스템에 설치된 Node.js 버전 목록을 확인합니다.
nvm ls특정 버전으로 전환하여 사용하려면 다음과 같이 입력합니다. 이 명령어를 통해 개발 환경에 맞는 특정 버전을 유연하게 사용할 수 있습니다.
nvm use 18기본 Node.js 버전 설정
터미널을 새로 열 때마다 자동으로 사용할 Node.js 버전을 지정합니다.
nvm alias default 18✅ Node.js 및 NPM 설치 확인하기
모든 설치 및 설정이 완료되었다면, Node.js와 함께 설치되는 패키지 관리 도구인 NPM(Node Package Manager)이 정상적으로 작동하는지 확인해야 합니다. 이 과정은 설치가 성공적으로 이루어졌는지 검증하는 최종 단계입니다.
버전 확인 명령어
터미널에 다음 두 명령어를 입력하여 설치된 버전을 확인합니다. 버전 번호가 출력되면 정상적으로 설치된 것입니다.
node -v npm -v만약 버전 번호가 출력되지 않고 오류 메시지가 나타난다면, NVM 환경 변수 설정 단계(~/.zshrc 또는 ~/.bash_profile 파일 수정)를 다시 한번 꼼꼼히 확인하고 source 명령어로 변경 사항을 적용했는지 확인해야 합니다.
Node.js와 NPM이 정상적으로 설치되었다면, 이제 Mac에서 웹 개발 프로젝트를 시작할 모든 준비가 완료된 것입니다. NVM 덕분에 향후 Node.js 버전 업데이트나 프로젝트별 버전 관리가 매우 용이해집니다.
🖥️ Mac Node.js 설치 중 발생할 수 있는 문제 해결하기
대부분의 경우 위 가이드대로 진행하면 문제없이 설치가 완료되지만, 간혹 Mac 환경, 특히 M1/M2 칩 환경에서 몇 가지 문제가 발생할 수 있습니다. 가장 흔한 문제와 해결 방법을 알아봅니다.
Apple Silicon(M1/M2) 환경에서의 Path 오류
Apple Silicon Mac에서는 Homebrew가 기본적으로 /opt/homebrew 경로에 설치됩니다. NVM 설정 시 이 경로가 제대로 반영되지 않아 오류가 발생하는 경우가 있습니다. 위의 ‘NVM 환경 변수 설정’에서 제공된 스크립트는 이 문제를 해결하도록 최적화되어 있으니, 스크립트를 정확히 복사하여 붙여넣었는지 확인하는 것이 중요합니다.
Permission Denied (권한 거부) 오류
이 오류는 NVM을 사용하지 않고 직접 Node.js를 설치했을 때 주로 발생합니다. Node.js를 시스템 경로에 설치하려고 시도하지만 권한이 없어 발생하는 문제로, NVM을 사용하여 설치하면 이 문제가 원천적으로 해결됩니다. 이미 Homebrew나 다른 방법으로 설치한 Node.js가 있다면, 이를 먼저 제거하고 NVM으로 다시 설치하는 것을 권장합니다.
설치 속도 지연 또는 실패
Node.js 다운로드 속도가 느리거나 설치에 실패하는 경우, 네트워크 연결 상태를 확인하고 잠시 후 다시 시도해 보세요. 또한, NVM 설치 시 Homebrew가 최신 상태인지 brew update 명령어를 통해 확인하는 것도 도움이 될 수 있습니다.
마무리하며: Node.js 버전 관리의 중요성
웹 개발 환경에서 Node.js의 버전 관리는 단순히 최신 버전을 사용하는 것을 넘어, 프로젝트의 안정성과 호환성을 유지하는 데 핵심적인 역할을 합니다. Node.js는 주기적으로 업데이트되며, 새로운 버전이 나올 때마다 기존 버전과의 비호환성이 발생할 수 있습니다. NVM을 사용하면 각 프로젝트 디렉토리마다 필요한 Node.js 버전을 설정할 수 있어, 한 프로젝트는 LTS 18.x를 사용하고 다른 프로젝트는 최신 20.x 버전을 사용하는 등 유연한 개발 환경을 구축할 수 있습니다. 이러한 버전 관리의 유연성은 Mac 개발자들에게 매우 중요한 장점입니다. 2025년 현재, 이 NVM 기반 설치 방법은 Mac 환경에서 가장 효율적이고 안정적인 Node.js 환경 설정의 표준으로 자리 잡았습니다. 이 가이드를 통해 Mac에서 Node.js 개발을 성공적으로 시작하시기를 바랍니다.
📌 추가로 참고할 만한 글
자주 묻는 질문 (FAQ)
Q. Homebrew를 사용하지 않고 NVM을 설치할 수 있나요 확인하기
A. 네, Homebrew 없이도 NVM을 설치할 수 있습니다. NVM 공식 GitHub 페이지에서 제공하는 설치 스크립트(curl 또는 wget 이용)를 직접 사용하여 설치할 수 있습니다. 다만, Homebrew를 사용하는 것이 macOS 환경에서 패키지 관리에 더 일반적이고 편리하여 권장됩니다.
Q. M1 Mac에서 Node.js 설치 시 로제타(Rosetta)가 필요한가요 상세 더보기
A. 2025년 현재, Node.js와 Homebrew 모두 Apple Silicon(M1/M2) 칩에 대한 네이티브 지원을 완벽하게 제공하고 있습니다. 따라서 Node.js를 설치하고 실행하는 데 로제타(Rosetta) 에뮬레이션은 필요하지 않으며, 네이티브 환경에서 최고의 성능으로 사용할 수 있습니다.
Q. Node.js 설치 후 NPM이 자동으로 설치되나요 보기
A. 네, NVM을 사용하여 Node.js 버전을 설치하면 해당 Node.js 버전에 맞는 NPM(Node Package Manager)이 자동으로 함께 설치됩니다. 따라서 별도로 NPM을 설치할 필요는 없으며, npm -v 명령어로 버전을 확인하여 정상 작동 여부를 검증할 수 있습니다.
Q. Node.js 버전을 삭제하려면 어떻게 해야 하나요 신청하기
A. NVM을 사용하여 설치된 Node.js 버전을 삭제하려면 nvm uninstall [버전번호] 명령어를 사용합니다. 예를 들어, 14.x 버전을 삭제하려면 nvm uninstall 14를 입력하면 됩니다. 단, 현재 사용 중인 버전은 삭제할 수 없습니다.