【초보자도 OK】맥 파이썬 설치부터 개발 환경 구축까지 완벽 정리

개발자라면 Python 설치는 필수입니다. 새 Mac에 로컬 개발 환경을 구성해두면 언제 어디서든 Python 코드를 작성하고 프로그램을 개발할 수 있습니다. 하지만 Mac 초보자나 Python 입문자에게는 설치부터 환경 설정까지의 과정이 만만치 않게 느껴지고, 자꾸 에러만 뜨고 도무지 설치가 안 돼서 답답했던 경험, 한 번쯤 있으실 겁니다.

이제 그 고민, 여기서 끝내세요. 지금부터 맥 파이썬 설치 및 개발 환경 구축 방법을 하나하나 알려드리겠습니다.

시작하기 전에: Mac 저장 공간 확인하기

공식 사이트에서 Python을 설치할 경우 보통 수백 MB 정도의 용량이 필요합니다. 하지만 Anaconda나 Homebrew를 이용해 설치하면 수 GB의 여유 공간이 필요할 수 있습니다. 게다가 앞으로 Python 패키지, 라이브러리, 가상 환경 등을 설치하다 보면 적게는 몇 GB, 많게는 30GB 이상까지 용량을 차지하게 됩니다.

따라서 설치 전에 반드시 시스템 설정 → 일반 → 저장 공간에서 Mac의 사용 가능한 용량을 확인하세요.

위 이미지처럼 사용 가능한 저장 공간이 10GB 미만이라면, Python 설치 전에 디스크 정리를 먼저 해주는 것이 좋습니다. Mac의 정크 파일을 빠르게 찾아 삭제하려면 전문 Mac 클리너 앱 BuhoCleaner 를 추천합니다. 클릭 한 번으로 불필요한 캐시, 로그, 임시 파일을 싹 정리해 10~20GB 이상의 공간을 단 몇 분 만에 확보할 수 있습니다.

맥 파이썬 설치를 위한 필수 조건

맥북 파이썬 설치를 진행하기 전에 아래 두 가지 조건을 확인하세요.

• macOS 10.15 Catalina 이상
• Mac에 충분한 여유 저장 공간 확보

Python이 이미 설치되어 있는지 확인하는 방법

사실 일부 macOS 버전에는 Python이 기본으로 설치되어 있습니다. 하지만 버전이 오래되었을 가능성이 높으므로, 최신 버전으로 업데이트가 필요합니다.

지금 사용 중인 Mac/MacBook에 Python이 설치되어 있는지 먼저 확인해볼까요?

1단계: 터미널을 열고 아래 명령어를 입력한 후 Enter 키를 누르세요.

python --version

2단계: 숫자가 표시되면 현재 설치된 Python 버전을 의미합니다. 만약 zsh: command not found: python 이라고 뜬다면 Python이 설치되어 있지 않은 상태입니다.

자, 이제 본격적으로 맥 파이썬 설치 방법을 알아보겠습니다.

Mac에서 Python 설치하고 개발 환경 구축하기

방법 1: 공식 사이트에서 Python 다운로드하기 (가장 쉬운 방법)

1단계: Python 공식 사이트에 접속해 Download Python 3.14.5 버튼을 클릭하여 최신 버전을 다운로드합니다.

2단계: 다운로드가 완료되면 .pkg 파일을 더블 클릭하고 화면 안내에 따라 설치를 진행하면 끝입니다. 별도의 설정 없이 "계속"만 눌러도 설치가 완료되므로 Mac 초보자에게 가장 추천하는 방법입니다.

방법 2: Homebrew로 Python 설치하기 (개발자 추천)

Homebrew를 이용하면 Python 버전 관리가 훨씬 수월해집니다. 나중에 Python 버전을 바꾸거나 여러 버전을 동시에 사용해야 할 때 특히 유용한 방법입니다.

1단계: Homebrew 설치하기

먼저 Homebrew를 설치합니다.

1) 터미널을 열고 아래 명령어를 복사해 실행하세요.

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

2) Mac 로그인 비밀번호를 입력하고 Enter 키를 누릅니다.

3) 설치 도중에 Enter 또는 Return 키를 누르라는 메시지가 나오면 눌러서 계속 진행합니다.

잠시 기다리면 아래와 같은 화면이 나타나면서 Homebrew 설치가 완료됩니다.

2단계: pyenv 설치하기

pyenv는 Python 버전을 자유롭게 전환할 수 있게 해주는 필수 도구입니다. 터미널에서 아래 명령어를 실행하여 설치하세요.

brew install pyenv

잠시 후 아래 이미지처럼 표시되면 pyenv 설치가 완료된 것입니다.

설치가 잘 되었는지 확인하려면 pyenv -v 명령어를 실행해보세요. pyenv 2.6.31 같은 버전 정보가 표시되면 정상입니다.

이제 Python을 설치하기 전에 pyenv 환경 설정을 해야 합니다. 아래 세 줄의 명령어를 한 줄씩 순서대로 실행하세요. 이 과정은 pyenv 초기화 설정을 .zshrc 파일에 기록하는 작업입니다.

• echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
• echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc
• echo 'eval "$(pyenv init -)"' >> ~/.zshrc

이어서 아래 명령어를 실행하면 pyenv 설정이 적용됩니다.

source ~/.zshrc

3단계: Python 설치하기

먼저 설치 가능한 Python 버전 목록을 확인해볼까요? 터미널에서 아래 명령어를 실행하세요.

pyenv install --list

여기에 표시된 숫자들이 현재 설치 가능한 Python 버전입니다. 이 글에서는 최신 버전인 3.14.5를 설치하겠습니다.

1) 아래 명령어를 실행하여 Python 3.14.5를 설치합니다.

pyenv install 3.14.5

2) 잠시 기다리면 Mac 사용자 이름과 Python 버전 번호가 표시되면서 설치가 완료됩니다.

3) 아래 명령어를 실행하면 현재 설치된 Python 버전 목록을 확인할 수 있습니다. 아래 이미지처럼 3.14.5가 보이면 Python이 정상적으로 설치된 것입니다.

pyenv versions

하지만 여기서 끝이 아닙니다! 이 상태로는 아직 최신 Python을 바로 사용할 수 없습니다. Mac에 기존 Python이 설치되어 있으면 그 버전을 계속 사용하게 되고, 설치되어 있지 않아도 명령어가 연결되지 않습니다.

Mac에서 방금 설치한 최신 Python을 기본으로 사용하려면 아래 명령어를 꼭 실행하세요.

pyenv global 3.14.5

이제 python --version을 입력하면 Python 3.14.5라고 표시됩니다. 드디어 최신 Python을 사용할 준비가 끝났습니다!

마치며

지금까지 맥북 파이썬 설치와 개발 환경 구축 방법을 두 가지(공식 사이트 직접 설치, Homebrew + pyenv)로 나누어 상세히 알아보았습니다.

• "간편하게 빨리 설치하고 싶다" → 공식 사이트 다운로드
• "앞으로 버전 관리도 유연하게 하고 싶다" → Homebrew + pyenv

둘 중 본인에게 맞는 방법으로 따라 해보세요. 모든 과정을 이미지와 함께 설명했으니 처음이라도 충분히 해내실 수 있습니다.

설치 전 저장 공간이 부족하다면 BuhoCleaner로 정크 파일을 정리하고 시작하세요. 용량 걱정 없이 쾌적한 개발 환경을 만들 수 있습니다.

이제 Python과 함께 즐거운 코딩 되세요!