💻 맥북에 파이썬 설치를 위한 필수 준비 사항 확인하기
맥북에서 파이썬을 효과적으로 사용하려면 설치 전 몇 가지 준비가 필요합니다. 특히 2025년 현재, 애플 실리콘 칩(M1, M2 등)이 탑재된 맥이 보편화되면서 설치 방법에도 약간의 차이가 생겼습니다. 이 가이드에서는 최신 macOS 환경을 기준으로 가장 안정적이고 효율적인 파이썬 설치 방법을 안내합니다.
📚 함께 읽으면 좋은 글
가장 먼저 확인해야 할 것은 현재 시스템에 파이썬이 설치되어 있는지 여부입니다. macOS는 기본적으로 시스템 파이썬(Python 2 또는 오래된 Python 3)을 내장하고 있지만, 이는 시스템 운영에 사용되는 버전이므로 개발 목적으로는 별도의 최신 버전을 설치하는 것이 좋습니다. 터미널을 열고 python3 --version 명령어를 입력하여 현재 설치된 버전을 확인해 보세요.
또한, 맥 환경에서 패키지 관리를 편리하게 하기 위해 Homebrew(홈브루)라는 패키지 관리자를 설치하는 것을 강력하게 추천합니다. Homebrew는 파이썬뿐만 아니라 다양한 개발 도구를 쉽게 설치하고 관리할 수 있게 해주는 필수 도구입니다.
🛠️ Homebrew를 이용한 파이썬 설치 단계 상세 더보기
Homebrew를 설치했다면, 파이썬을 설치하는 과정은 매우 간단합니다. Homebrew는 파이썬 설치 시 필요한 모든 종속성을 자동으로 처리해주기 때문에 가장 권장되는 방식입니다. 특히 애플 실리콘(M1, M2) 칩 환경에서는 아키텍처 호환성 문제를 자동으로 해결해 줍니다.
➡️ 1단계 Homebrew를 통한 파이썬 설치 명령 확인하기
터미널에서 다음 명령어를 입력하여 최신 버전의 파이썬 3를 설치합니다. 파이썬은 빠르게 업데이트되므로, 2025년 현재는 안정적인 최신 3.x 버전을 설치하게 됩니다.
brew install python
설치가 완료되면 Homebrew는 파이썬이 어디에 설치되었는지와 함께 환경 변수를 설정하는 방법을 안내해줍니다. 일반적으로 Homebrew로 설치된 파이썬은 /opt/homebrew/bin/python3 (애플 실리콘) 또는 /usr/local/bin/python3 (인텔) 경로에 위치합니다.
➡️ 2단계 설치 확인 및 심볼릭 링크 점검
설치가 제대로 되었는지 확인하기 위해 다음 명령어를 입력합니다. 출력되는 버전 정보가 설치한 최신 버전과 일치해야 합니다.
python3 --version
Homebrew는 자동으로 python3 명령어를 방금 설치한 버전으로 연결(심볼릭 링크)해주지만, 가끔 pip 명령어를 사용할 때 시스템 기본 파이썬과 충돌하는 경우가 있습니다. pip3 명령어가 Homebrew로 설치된 파이썬과 정확하게 연결되어 있는지 확인하는 것이 중요합니다.
⚙️ macOS 환경 변수 설정 및 경로 충돌 해결 방법 보기
파이썬을 설치한 후 가장 흔하게 겪는 문제는 ‘어떤 파이썬이 실행되는가’에 대한 환경 변수(PATH) 문제입니다. macOS에는 시스템 기본 파이썬이 있기 때문에, 개발자가 의도한 Homebrew 설치 버전이 아닌 다른 버전이 실행될 수 있습니다.
➡️ 셸 프로필 파일 수정으로 우선순위 설정
대부분의 최신 macOS 사용자는 Zsh 셸을 사용합니다. 환경 변수를 수정하려면 ~/.zshrc 파일을 편집해야 합니다. Bash 셸을 사용한다면 ~/.bash_profile 파일을 수정합니다.
nano ~/.zshrc
파일 맨 아래에 Homebrew 경로가 시스템 기본 경로보다 먼저 검색되도록 다음 줄을 추가합니다. 이는 Homebrew로 설치된 버전이 시스템 기본 버전보다 높은 우선순위를 가지도록 합니다.
export PATH="/opt/homebrew/bin:$PATH"
M1/M2 맥북 사용자의 경우 /opt/homebrew/bin 경로가 애플 실리콘용 Homebrew의 기본 설치 경로입니다. 인텔 맥북 사용자는 /usr/local/bin 경로를 확인해야 할 수 있습니다.
➡️ 변경 사항 적용 및 확인
파일을 저장하고 닫은 후, 변경된 환경 변수를 현재 셸 세션에 적용합니다.
source ~/.zshrc
이후 which python3 명령어를 실행했을 때 Homebrew 설치 경로(예: /opt/homebrew/bin/python3)가 출력되는지 확인하세요. 이 과정을 통해 시스템 파이썬과의 충돌 없이 최신 버전을 개발 환경으로 사용할 수 있습니다.
🍎 M1 M2 맥북에서의 파이썬 설치 주의사항 확인하기
애플 실리콘 칩(M1, M2, M3 등)이 탑재된 맥북은 기존 인텔 맥북과는 아키텍처가 다릅니다. 이로 인해 파이썬 패키지(라이브러리) 중 일부가 네이티브(arm64) 지원을 하지 않아 문제가 발생할 수 있었습니다. 그러나 2025년 현재 대부분의 주요 라이브러리는 이미 애플 실리콘을 완벽하게 지원하고 있습니다.
➡️ 네이티브 지원 및 Rosetta 2의 역할
Homebrew는 애플 실리콘 환경에서 네이티브 arm64 버전을 자동으로 설치해 줍니다. 만약 특정 라이브러리가 arm64를 지원하지 않아 설치에 문제가 생긴다면, 임시방편으로 Rosetta 2 환경에서 별도의 Homebrew 인스턴스를 설치하고 인텔(x86_64) 버전을 설치해 사용해야 할 수도 있습니다. 하지만 이는 극히 드문 경우이며, 대부분의 사용자는 Homebrew의 기본 설치만으로 충분합니다.
파이썬 개발 환경을 관리하기 위해 venv, conda와 같은 가상 환경 관리 도구를 사용하는 것이 좋습니다. 가상 환경을 사용하면 프로젝트별로 필요한 파이썬 버전과 라이브러리 목록을 격리하여 관리할 수 있어 시스템 전체 환경에 영향을 주지 않습니다.
💡 가상 환경 관리와 pip 사용법 상세 더보기
파이썬 개발의 핵심은 프로젝트별로 독립된 환경을 구축하는 것입니다. 이 과정을 가상 환경(Virtual Environment)이라고 합니다. 가상 환경을 사용하면 한 프로젝트에서 특정 라이브러리 버전이 필요하더라도 다른 프로젝트에 영향을 주지 않습니다.
➡️ venv를 이용한 가상 환경 생성 및 활성화
파이썬 3.3 버전부터는 내장 모듈인 venv를 통해 가상 환경을 쉽게 만들 수 있습니다. 프로젝트 폴더로 이동한 후 다음 명령어를 사용합니다.
python3 -m venv my_project_env
위 명령어는 현재 폴더에 my_project_env라는 이름의 가상 환경 폴더를 생성합니다. 생성 후에는 다음 명령어로 활성화합니다. 터미널 프롬프트 앞에 가상 환경 이름이 나타나면 활성화된 것입니다.
source my_project_env/bin/activate
➡️ 라이브러리 설치 및 관리
가상 환경이 활성화된 상태에서 pip 명령어를 사용하여 필요한 라이브러리(예: NumPy, Pandas)를 설치합니다. 이 라이브러리는 현재 활성화된 가상 환경에만 설치됩니다.
pip install numpy pandas
가상 환경 사용을 마쳤다면 deactivate 명령어로 비활성화합니다. 이렇게 함으로써 시스템 환경은 깨끗하게 유지되고, 개발 프로젝트의 의존성 관리가 명확해집니다.
❓ 자주 묻는 질문 (FAQ)
Q1. macOS 기본 설치된 파이썬을 사용하면 안 되나요?
A. 시스템에 기본으로 설치된 파이썬은 macOS 운영체제가 의존하는 중요한 구성 요소입니다. 개발 목적으로 사용하거나 라이브러리를 설치하면 시스템 파일이 손상되거나 예측하지 못한 오류가 발생할 수 있습니다. 따라서 Homebrew 등을 통해 별도의 최신 파이썬 버전을 설치하고 사용하는 것이 안전하며 권장됩니다.
Q2. Homebrew 대신 공식 웹사이트 설치 파일을 사용해도 되나요?
A. 네, 공식 웹사이트에서 다운로드한 설치 파일(.pkg)을 사용해도 무방합니다. 다만, Homebrew는 설치뿐만 아니라 업데이트, 제거, 환경 변수 설정 등 전반적인 관리가 매우 편리하고 간결하여 개발자들에게 더 선호됩니다. Homebrew를 사용하면 맥북의 다양한 개발 도구를 통합적으로 관리할 수 있습니다.
Q3. 파이썬을 여러 버전(예: 3.9와 3.11)으로 설치하고 싶어요. 어떻게 해야 하나요?
A. Homebrew를 이용하면 여러 버전을 설치할 수 있습니다 (예: brew install python@3.9). 하지만 여러 버전을 쉽게 전환하며 관리하려면 pyenv와 같은 파이썬 버전 관리 도구를 사용하는 것이 가장 효율적입니다. pyenv는 시스템에 설치된 다양한 파이썬 버전을 손쉽게 전환할 수 있게 해줍니다.
파이썬 설치는 모든 개발 여정의 첫걸음입니다. 이 가이드를 통해 맥북 환경에서 안정적이고 효율적인 개발 환경을 구축하시길 바랍니다.