[Mac] mac에 node.js 설치하기 (homebrew, nvm 사용)

회사에서 신규로 react로 구성된 프로젝트를 맡게 되었다.
대충은 못하는 성격이라 퇴근 후에 공부하면서 mac에 환경을 구성해보았다.
기록으로 남겨야 나중에 다시 볼 때 편할 것 같다.

🧩 1. nvm 설치 (Homebrew 사용)

brew install nvm

옵션 설명

• brew install nvm: Homebrew 패키지 관리자를 통해 nvm(Node Version Manager)을 설치합니다.

설치가 완료되면 안내 메시지에 설정 경로가 표시됩니다. 보통 다음 경로를 만들어야 합니다:

mkdir ~/.nvm

---

⚙️ 2. 셸 환경 설정

nvm은 bash / zsh 등 셸 초기화 파일에 환경 변수를 추가해야 합니다.
사용 중인 셸에 따라 아래 중 하나를 수정하세요:

zsh (macOS 기본 셸)

nano ~/.zshrc

bash 사용 시

nano ~/.bash_profile

파일 맨 아래에 다음 내용을 추가합니다 👇

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.d/nvm" ] && \. "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm"

옵션 설명

• export NVM_DIR="$HOME/.nvm": nvm 환경 변수가 저장될 디렉터리 지정.

• [ -s "파일경로" ] && \. "파일경로": 파일이 존재할 경우(-s) 해당 스크립트를 현재 셸에 로드(.)합니다.

변경 후 셸을 다시 로드합니다:

source ~/.zshrc

---

🧠 3. nvm 설치 확인

nvm --version

출력 예시:

0.39.7

→ 이런 식으로 버전이 나오면 정상적으로 설치된 것입니다.

---

🚀 4. Node LTS 버전 설치

nvm install --lts

옵션 설명

• --lts: Long Term Support(장기 지원) 버전 설치. 안정적인 Node 버전을 설치합니다.

설치 완료 후 자동으로 해당 버전을 활성화하려면:

nvm use --lts

현재 사용 중인 Node 버전 확인:

node -v

---

📦 5. 프로젝트 기본 버전 설정 (선택사항)

프로젝트 루트에서:

echo "lts/*" > .nvmrc

이제 프로젝트 디렉터리에 들어올 때마다 자동으로 LTS 버전 사용이 가능합니다:

nvm use

---

✅ 최종 점검

nvm list

출력 예시:

->     v20.18.0
        system
default -> lts/* (-> v20.18.0)
node -> stable (-> v20.18.0) (default)

모두 정상이라면, 이제 Node LTS 버전 환경이 완벽히 구성된 상태입니다 🎉

---