macOS에서 Node.js 설치를 하려다 보면 “뭘로 깔아야 오래 안 꼬이지?”가 제일 먼저 막힙니다.
결론부터 말하면 프로젝트가 여러 개면 nvm, 간단히 최신만 쓰면 Homebrew, 회사PC/초보·표준화면 공식 pkg가 편합니다.
이 글에서는 2026 기준으로 Node.js 설치 3가지를 “버전 관리/업데이트/충돌 가능성/복구 난이도”까지 비교하고, 상황별 추천 조합을 딱 정리해드릴게요.
한눈에 비교: nvm vs Homebrew vs 공식 설치(pkg)
| 방법 | 추천 대상 | 장점 | 주의점(꼬이는 포인트) |
|---|---|---|---|
| nvm | 여러 프로젝트/버전 동시 사용, 팀 개발 | 버전 스위칭이 매우 쉬움(.nvmrc), 충돌 적음 | 초기 셸 설정(zsh)·PATH 이해가 필요 |
| Homebrew | 최신 1개 버전만 빠르게, 맥 기본 툴 체인 | 설치/업데이트 단순(brew upgrade), 관리 편함 | 프로젝트별 버전 고정이 약함, nvm과 혼용 시 충돌 |
| 공식 설치(pkg) | 초보/회사PC, 표준 설치 선호 | GUI로 끝, “그냥 되게” 설치 | 삭제/업데이트가 번거롭고, Homebrew/nvm과 섞이면 꼬이기 쉬움 |
결론 먼저: 내 상황별 추천 시나리오
- 입문 + 튜토리얼/강의 따라가기 → Homebrew 또는 공식 pkg (가장 빠르게 시작)
- 프로젝트가 2개 이상(레거시/최신 혼재) → nvm (버전 스위칭이 핵심)
- 회사/교육기관 PC(보안 정책, 관리자 계정 제한) → 공식 pkg (승인받기 쉬움)
- 팀에서 “이 버전으로 고정”을 요구 → nvm + .nvmrc (재현성 최우선)
공통 체크: 이미 깔려있는 Node가 있는지 먼저 확인
설치 전 “중복 설치”를 피하려고 현재 상태부터 확인합니다. 이미 Node.js 설치가 되어 있는데 다른 방식으로 또 깔면, PATH 우선순위 때문에 버전이 왔다 갔다 하는 일이 흔합니다.
# 현재 node/npm 위치와 버전 확인
which node
node -v
which npm
npm -v
# (선택) npx도 확인
which npx
npx -v
결과가 /usr/local/bin 또는 /opt/homebrew/bin이면 Homebrew 계열일 가능성이 높고,
~/.nvm/ 아래로 나오면 nvm 쪽일 가능성이 큽니다.
방법 1) nvm으로 설치(추천 1순위: 여러 프로젝트/버전 관리)
nvm 설치 → LTS 설치 → 기본 버전 고정
가장 “덜 꼬이는” Node.js 설치 방식은 nvm입니다. 이유는 단순해요. Node 자체를 시스템 전역에 박아두지 않고, 사용자 홈 디렉토리 아래에서 버전을 분리해 관리하기 때문입니다.
# 1) nvm 설치(터미널에서 실행)
# 아래 설치 스크립트는 nvm 공식 저장소 안내 방식과 동일한 형태로 제공됩니다.
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 2) 터미널 재시작 또는 zsh 설정 로드
source ~/.zshrc
# 3) LTS 설치
nvm install --lts
# 4) 기본 버전 지정
nvm alias default lts/*
# 5) 확인
node -v
npm -v
.nvmrc로 “팀/프로젝트 버전 고정”하기
프로젝트 루트에 .nvmrc 파일 하나만 두면, 팀원 모두가 같은 Node 버전을 쉽게 맞출 수 있습니다.
# 프로젝트 폴더에서
node -v
# 예: v20.11.1 같은 버전이 나온다면, 아래처럼 저장
echo "20" > .nvmrc
# 다음부터는
nvm use
이런 “재현성” 때문에 실무에서는 nvm 기반 Node.js 설치가 가장 많이 추천됩니다.
nvm에서 자주 나는 오류 3가지(바로 해결)
-
nvm: command not found
→~/.zshrc에 nvm 로드 구문이 빠진 경우가 많습니다. 설치 스크립트를 다시 실행하거나, 터미널을 완전히 재시작해보세요. -
node는 되는데 VSCode 터미널에서만 안 됨
→ VSCode가 로그인 셸을 안 불러오는 설정일 수 있습니다. VSCode 터미널을 “로그인 셸”로 쓰거나, zsh 설정 로드가 되는지 확인하세요. -
권한 오류(EACCES)로 글로벌 설치 실패
→ nvm 환경에서는 보통 권한 문제가 줄어듭니다. 그래도 생기면sudo npm i -g를 습관처럼 쓰지 말고, PATH/설치 위치를 먼저 확인하세요.
방법 2) Homebrew로 설치(빠르고 깔끔, “최신 1개”에 강함)
Homebrew는 맥 개발환경의 “패키지 매니저”라서, Node.js 설치도 가장 단순한 편입니다. 다만 프로젝트별로 Node 버전을 고정해야 한다면 nvm 쪽이 더 안전합니다.
# 설치
brew update
brew install node
# 확인
node -v
npm -v
# 업데이트
brew upgrade node
Homebrew 설치가 꼬일 때 체크 2가지
- brew command not found → Homebrew 자체 설치/경로(PAT H)부터 복구
- node 버전이 기대와 다름 → nvm/공식 pkg가 같이 깔려 PATH 우선순위가 바뀐 경우가 많음
방법 3) 공식 설치(pkg)로 설치(초보/회사PC에 최적)
공식 설치(pkg)는 “그냥 설치하고 끝”이라는 장점이 있습니다. 특히 회사 PC처럼 Homebrew 설치가 제한되거나, 터미널 기반 세팅이 부담스러울 때 Node.js 설치를 가장 빨리 완료할 수 있어요.
- Node.js 공식 다운로드 페이지에서 macOS Installer(.pkg) 선택
- 설치 마법사 진행
- 터미널에서
node -v,npm -v확인
다만 “나중에 지우고 다시 깔기/버전 내리기/여러 버전 공존”이 필요해지면, 공식 pkg는 점점 불편해질 수 있습니다.
가장 흔한 함정: 3가지 방식 “혼용”하면 벌어지는 일
한 번이라도 Node.js 설치를 여러 방식으로 섞어버리면, 같은 컴퓨터에서 “설치했는데 버전이 바뀌지 않는다” 같은 현상이 생깁니다. 핵심은 딱 하나: PATH 우선순위입니다.
- 증상:
node -v가 계속 옛날 버전 - 원인: 다른 위치의 node가 먼저 잡힘(
which node로 확인 가능) - 해결: “주력 방식 1개”만 남기고 정리(특히 nvm을 쓰면 전역 설치는 최소화)
# 현재 우선순위 확인
which -a node
which -a npm
# 쉘이 인식하는 캐시 초기화(가끔 필요)
hash -r
추천 조합: (2026) 가장 무난한 “막힘 없는” 루트
- 초보 루트: Homebrew 설치 → Homebrew로 Node 설치 → VSCode에서 npm 스크립트 실행
- 실전 루트: Homebrew 설치(도구 체인) → nvm 설치 → 프로젝트마다
.nvmrc고정 - 회사 루트: 공식 pkg로 Node 설치 → 정책 허용 시에만 Homebrew/nvm로 확장
마무리: 지금 내 선택은?
정리하면, 장기적으로 가장 덜 스트레스 받는 Node.js 설치는 nvm이고, “일단 빨리 시작”은 Homebrew/공식 pkg가 편합니다. 특히 프로젝트를 하나라도 더 하게 될 가능성이 있다면, 처음부터 nvm으로 가는 편이 나중에 갈아엎는 비용이 거의 없습니다.
0 댓글