[맥북 세팅] 개발자를 위한 완벽한 Node.js(v22) & Python(3.12) 설치 가이드

맥북을 새로 샀거나 초기화했을 때, 가장 먼저 해야 할 일은 개발 환경을 세팅하는 것입니다. 하지만 무작정 brew install node나 brew install python을 입력했다가는 나중에 권한 문제(EACCES)나 버전 꼬임 현상으로 고생하기 십상입니다.

오늘은 가장 공식적이고 안정적인 방법으로 Node.js(v22)와 Python(3.12)을 설치하는 방법을 정리합니다.

핵심 요약

• Node.js: Homebrew가 아닌 공식 스크립트로 nvm을 설치합니다.

• Python: Homebrew로 pyenv를 설치하되, 빌드 의존성을 먼저 챙깁니다.

1. 사전 준비 (Terminal & Xcode Tools)

설치를 시작하기 전, 맥북의 터미널(Terminal)을 열고 기본 준비를 마쳐야 합니다.

1) 쉘(Shell) 확인하기 맥북의 기본 쉘인 zsh 환경인지 확인합니다. 터미널 창 상단에 zsh라고 적혀 있으면 됩니다.

2) Xcode Command Line Tools 설치 모든 개발 툴의 기초가 되는 컴파일러를 설치합니다.

xcode-select --install

(이미 설치되었다는 팝업이 뜨면 넘어가셔도 됩니다.)

2. Node.js (v22) 설치: NVM 활용하기

많은 분들이 실수하는 부분이 brew install nvm을 하는 것입니다. nvm 공식 문서에서는 Homebrew 설치를 지원하지 않으며, 삭제를 권장합니다. 우리는 공식 설치 스크립트를 사용합니다.

Step 1. NVM 설치 스크립트 실행

터미널에 아래 명령어를 입력하여 nvm을 설치합니다.

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

(버전 v0.40.1은 최신 버전에 따라 달라질 수 있습니다.)

Step 2. 환경 변수 설정 (중요!)

설치가 끝나도 nvm 명령어가 바로 먹히지 않습니다. ~/.zshrc 파일에 설정을 등록해야 합니다.

# 1. 설정 파일 열기
nano ~/.zshrc

# 2. 파일 맨 아래에 다음 코드가 있는지 확인하고, 없으면 복사해서 붙여넣기
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

# 3. 저장하고 나오기 (Ctrl+O -> Enter -> Ctrl+X)

Step 3. 설정 적용 및 Node.js v22 설치

# 설정 적용
source ~/.zshrc

# Node.js v22 설치
nvm install 22

# 기본 버전으로 설정
nvm use 22
nvm alias default 22

이제 node -v를 입력했을 때 v22.x.x가 나온다면 성공입니다!

3. Python (3.12) 설치: Pyenv 활용하기

파이썬은 맥북 시스템 자체에도 깔려있지만, 절대 시스템 파이썬을 건드리면 안 됩니다. 버전 관리를 위해 pyenv를 사용합니다. pyenv는 Node와 달리 Homebrew로 설치하는 것이 정석입니다.

Step 1. 빌드 의존성 패키지 설치 (필수)

이 단계를 건너뛰면 파이썬 설치 중에 "Build failed" 에러가 뜹니다.

brew install openssl readline sqlite3 xz zlib tcl-tk

Step 2. Pyenv 설치

brew install pyenv

Step 3. 환경 변수 설정 (가장 중요한 단계)

설치만 하면 터미널이 pyenv를 인식하지 못합니다. 다시 한번 ~/.zshrc를 수정합니다.

# 1. 설정 파일에 환경변수 추가 (한 줄씩 터미널에 복사-붙여넣기 하세요)
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
echo '[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(pyenv init -)"' >> ~/.zshrc

# 2. 설정 적용
source ~/.zshrc

Step 4. Python 3.12 설치

최신 안정 버전인 3.12 대의 최신 버전을 설치합니다.

# 설치 가능한 3.12 버전 리스트 확인 (생략 가능)
# pyenv install --list | grep 3.12

# Python 3.12 설치 (시간이 조금 걸립니다)
pyenv install 3.12.9

# 전역(Global) 설정
pyenv global 3.12.9

(3.12.9 버전은 작성 시점 기준 예시이며, 설치 시점에 3.12.x 중 가장 높은 숫자를 입력하면 됩니다.)

이제 python --version을 입력했을 때 Python 3.12.9가 나온다면 성공입니다!

4. 마무리 및 검증

모든 설치가 끝났습니다. 터미널을 완전히 종료했다가 다시 켠 후, 아래 명령어들로 최종 확인을 해보세요.

node -v   # v22.x.x 확인
python --version  # Python 3.12.x 확인

이 방식은 각 언어의 생태계에서 공식적으로 권장하는 "가장 깨끗한" 설치 방법입니다. 프로젝트별로 버전이 달라져도 nvm use나 pyenv local 명령어로 손쉽게 대응할 수 있습니다.

쾌적한 개발 환경에서 즐거운 코딩 되시길 바랍니다!