Mac에서 Homebrew와 nvm을 활용한 Node.js 설치 및 프로젝트별 관리 가이드

Mac에서 Homebrew와 nvm을 활용한 Node.js 설치 및 프로젝트별 관리 가이드

🛠️ Mac에서 Node.js를 설치하는 가장 좋은 방법은?

웹 개발을 시작하려면 필수적으로 Node.js를 설치해야 합니다.

하지만 "어떤 버전을 설치해야 할까?", "업데이트는 어떻게 하지?", "프로젝트마다 다른 버전을 사용하고 싶다면?" 같은 고민이 생길 수 있죠.

이럴 때 nvm(Node Version Manager) 을 사용하면 쉽고 깔끔하게 해결할 수 있습니다!

이 글에서는 Homebrew를 사용해 nvm을 설치하고, Node.js를 설치 및 관리하는 방법을 초보자도 이해할 수 있도록 자세히 설명하겠습니다. 🚀

---

1️⃣ Homebrew란?

🏗️ Homebrew란 무엇인가?

Homebrew는 Mac에서 소프트웨어를 쉽게 설치하고 관리할 수 있도록 도와주는 패키지 관리자입니다.

리눅스의 apt나 yum과 비슷한 역할을 합니다.

🔹 왜 Homebrew를 사용해야 할까?

Mac에는 기본적으로 패키지 관리 시스템이 부족하기 때문에, 직접 소프트웨어를 다운로드해서 설치하는 방식이 많습니다.

하지만 Homebrew를 사용하면 명령어 한 줄로 설치와 업데이트를 쉽게 할 수 있습니다.

---

2️⃣ Mac에서 Homebrew 설치 및 환경 변수 설정

🔹 터미널 실행 방법

1. 단축키 사용: Command (⌘) + Space 를 누른 후 terminal 입력 → Enter
2. Finder에서 실행:
   • 응용 프로그램 (Applications) → 유틸리티 (Utilities) → 터미널 (Terminal) 실행

터미널이 열렸다면, 이제 Homebrew를 설치해봅시다.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

👉 설명:

• 위 명령어는 Homebrew 공식 설치 스크립트를 다운로드하고 실행하는 역할을 합니다.
• Enter 키를 눌러 설치를 진행하세요.

🔹 Homebrew 환경 변수 적용

설치 후 환경 변수를 적용해야 터미널에서 brew 명령어를 사용할 수 있습니다.

아래 명령어를 실행하세요.

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrc

👉 설명:

• Homebrew가 정상적으로 동작하도록 ~/.zshrc 파일에 환경 변수를 추가합니다.
• source ~/.zshrc를 실행해 변경 사항을 즉시 적용합니다.

🔹 Homebrew 설치 확인

설치가 완료되면 아래 명령어를 실행하여 정상적으로 설치되었는지 확인합니다.

brew -v

출력 결과가 Homebrew <버전> 형식으로 나오면 정상 설치된 것입니다! 🎉

---

3️⃣ nvm(Node Version Manager)이란?

🌎 nvm이란 무엇인가?

nvm(Node Version Manager) 은 Node.js 버전을 쉽게 관리할 수 있도록 도와주는 도구입니다.

💡 nvm이 필요한 이유

• Node.js는 계속해서 업데이트됨→ 새로운 기능이 추가되거나 보안 패치가 이루어지기 때문
• 프로젝트마다 사용하는 버전이 다를 수 있음→ 예를 들어, A 프로젝트는 Node.js 16, B 프로젝트는 Node.js 18을 사용해야 할 수도 있음
• 버전 충돌을 방지→ 글로벌 환경에서 직접 설치하면 특정 프로젝트와 호환되지 않는 문제가 발생할 수 있음

이제 nvm을 설치해보겠습니다.

---

4️⃣ nvm 설치 및 환경 변수 설정

🔹 Homebrew를 사용해 nvm 설치

brew install nvm

👉 설명:

• brew install nvm 명령어를 실행하면 nvm이 자동으로 다운로드 및 설치됩니다.

설치가 끝났다면, nvm을 사용할 수 있도록 환경 변수를 설정해야 합니다.

nano ~/.zshrc

👉 설명:

• nano ~/.zshrc를 입력하면 nano 편집기가 열리며,~/.zshrc 파일은 Mac의 zsh 쉘이 실행될 때 자동으로 로드되는 설정 파일입니다.

🔹 .zshrc 파일에 아래 내용 추가

파일의 가장 아래쪽에 다음 내용을 입력하세요.

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

🔹 설정 파일 저장 후 적용

1. Ctrl + X 를 눌러 종료
2. Y 입력 후 Enter
3. 환경 변수를 적용하기 위해 다음 명령어 실행

source ~/.zshrc

이제 nvm이 정상적으로 설치되었습니다!

아래 명령어를 입력하여 nvm이 정상적으로 동작하는지 확인해보세요.

command -v nvm

출력값이 nvm이라면 정상적으로 설치된 것입니다! 🚀

---

5️⃣ Permission Denied 해결 방법

설치 과정에서 "Permission Denied" 오류가 발생할 경우, 파일 권한을 수정하면 해결할 수 있습니다.

🔹 파일 권한 수정

sudo chown -R $USER ~/.nvm
chmod -R 755 ~/.nvm

👉 설명:

• chown -R $USER ~/.nvm : 현재 사용자($USER)에게 ~/.nvm 폴더의 소유권을 부여
• chmod -R 755 ~/.nvm : 읽기/쓰기 권한을 설정

이제 다시 nvm이 정상 작동하는지 확인해보세요. 🚀

---

6️⃣ 프로젝트별로 자동으로 nvm 적용하기

각 프로젝트에서 .nvmrc 파일을 사용해 자동으로 Node.js 버전을 적용할 수 있습니다.

🔹 .nvmrc 파일 생성

echo "lts/*" > .nvmrc

🔹 자동으로 .nvmrc 실행되도록 설정

nano ~/.zshrc

맨 아래에 추가:

autoload -U add-zsh-hook
add-zsh-hook chpwd load-nvmrc
load-nvmrc() {
  if [[ -f .nvmrc && "$(nvm current)" != "$(cat .nvmrc)" ]]; then
    nvm use
  fi
}

source ~/.zshrc

이제 프로젝트 폴더로 이동하면 자동으로 해당 버전이 적용됩니다! 🎉