M1/M2 맥북에 기본 설치된 파이썬 때문에 개발용 최신 버전을 설치하려다 충돌이나 경로 문제로 막막했던 경험, 한 번쯤 있으실 겁니다.
이는 macOS가 자체적으로 시스템 유지보수에 필요한 파이썬 버전을 내장하고 있어, 사용자가 별도로 설치하는 버전과 충돌하기 쉬운 구조 때문입니다.
이 글에서는 Homebrew를 활용해 시스템 파이썬과 완벽히 분리된 최신 파이썬 개발 환경을 5단계로 구축하고, 구버전과의 충돌 없이 깔끔하게 관리하는 방법을 명확하게 알려드립니다.
– Homebrew를 이용해 시스템 파이썬과 완전히 독립적인 개발 환경을 구축합니다.
– M1/M2 칩셋에 최적화된 최신 파이썬 버전을 손쉽게 설치하고 관리합니다.
– PATH 설정을 통해 여러 파이썬 버전 충돌 없이 개발용 버전을 우선적으로 사용합니다.
M1/M2 맥북에 파이썬 최신 버전을 Homebrew로 설치하고, 기존 버전과의 충돌 없이 깔끔하게 관리하는 방법을 알려드립니다.
기본 파이썬과 개발용 파이썬, 왜 충돌할까요?
macOS는 시스템 운영에 필요한 자체 파이썬 버전을 기본으로 포함하고 있습니다. 주로 /usr/bin/python 또는 /usr/bin/python3 경로에 설치되어 있으며, 시스템 스크립트 실행 등 핵심적인 용도로 사용됩니다. 이 시스템 파이썬은 macOS 업데이트 시 함께 관리되므로, 사용자가 임의로 버전을 변경하거나 패키지를 설치하면 시스템 안정성에 문제가 발생할 수 있습니다.
반면, 우리가 개발에 사용하는 파이썬은 최신 기능과 라이브러리 호환성을 위해 주기적으로 업데이트가 필요합니다. 이 두 가지 파이썬이 서로 다른 경로에 존재하고, 환경 변수 PATH 설정에서 어떤 파이썬을 먼저 찾느냐에 따라 충돌이 발생하거나 예상치 못한 버전이 실행되는 문제가 생깁니다. 특히 M1/M2 칩셋 기반의 맥북에서는 아키텍처 호환성 문제까지 고려해야 할 때가 있습니다.
| 구분 | 시스템 파이썬 | 개발용 파이썬 (Homebrew) |
|---|---|---|
| 설치 경로 | /usr/bin/python3 |
/opt/homebrew/bin/python3 (M1/M2) |
| 관리 주체 | macOS | 사용자 (Homebrew) |
| 특징 | 안정성 위주, 버전 고정, 임의 수정 위험 | 최신 버전 유지, 자유로운 패키지 설치, 개발 편의성 |
Photo by Christina Morillo on Pexels
Homebrew 설치: 맥 개발 환경의 핵심 도구
Homebrew는 macOS용 패키지 관리자로, 복잡한 설치 과정 없이 터미널 명령 한 줄로 다양한 소프트웨어와 개발 도구를 손쉽게 설치하고 관리할 수 있게 해줍니다. 파이썬뿐만 아니라 Git, Node.js, Docker 등 수많은 개발 필수 도구들을 Homebrew를 통해 관리할 수 있어, 맥 개발자라면 반드시 설치해야 할 도구로 꼽힙니다.
설치 과정은 매우 간단하며, 대부분의 경우 3분 이내로 완료됩니다. 이미 Homebrew가 설치되어 있다면 다음 섹션으로 건너뛰셔도 좋습니다.
- 터미널 열기 — Spotlight 검색(
Command + Space)에서 ‘터미널’을 검색하여 실행합니다. - Homebrew 설치 명령 실행 — 터미널에 아래 명령어를 복사하여 붙여넣고 엔터를 누릅니다. 비밀번호를 요구하면 맥북 비밀번호를 입력합니다.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 설치 스크립트 완료 확인 — 스크립트가 실행되면 설치 과정이 터미널에 표시됩니다. “Installation successful!” 메시지가 나타나면 완료된 것입니다.
- PATH 설정 확인 — 설치 완료 후 터미널에 표시되는 “Next steps” 부분에 PATH 설정을 추가하라는 안내가 나옵니다. M1/M2 맥북의 경우,
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile와 같은 명령어를 입력하여 PATH를 추가합니다. - 터미널 재시작 — 변경된 PATH 설정을 적용하기 위해 터미널을 완전히 종료한 후 다시 실행합니다.
Homebrew로 파이썬 최신 버전 설치 및 환경 설정
Homebrew 설치를 마쳤다면, 이제 최신 버전의 파이썬을 설치할 차례입니다. Homebrew는 자동으로 M1/M2 칩셋에 최적화된 버전을 찾아 설치해주므로, 별도의 설정 없이 편리하게 사용할 수 있습니다.
터미널을 열고 다음 명령어를 입력하여 파이썬을 설치합니다. 이 명령은 현재 Homebrew에서 관리하는 가장 최신 파이썬 3 버전을 설치합니다.
brew install python설치가 완료되면 Homebrew는 자동으로 파이썬 실행 파일을 Homebrew가 관리하는 경로(예: /opt/homebrew/bin)에 추가하고, 이 경로가 시스템 PATH 환경 변수에 우선적으로 등록되도록 설정합니다. 이렇게 되면 터미널에서 python3 명령어를 입력했을 때 Homebrew로 설치된 파이썬이 가장 먼저 실행됩니다.
Homebrew 설치 시 PATH 설정이 제대로 이루어지지 않으면, Homebrew로 설치한 파이썬이 아닌 시스템 파이썬이 계속 실행될 수 있습니다.
echo $PATH 명령어를 통해 Homebrew 경로(예: /opt/homebrew/bin)가 /usr/bin보다 앞에 위치하는지 꼭 확인하세요. 만약 그렇지 않다면, ~/.zprofile 또는 ~/.bash_profile 파일에 export PATH="/opt/homebrew/bin:$PATH"와 같은 내용을 추가하고 터미널을 재시작해야 합니다.
Photo by Erdal Erdal on Pexels
설치 확인 및 가상 환경으로 효율적인 개발 시작
파이썬 설치가 제대로 되었는지 확인하는 것은 매우 중요합니다. 터미널을 재시작한 후 다음 명령어를 입력하여 설치된 파이썬의 버전과 경로를 확인합니다.
python3 --versionwhich python3
python3 --version 명령은 설치된 최신 파이썬 버전을, which python3 명령은 해당 파이썬 실행 파일의 경로를 보여줄 것입니다. 경로가 /opt/homebrew/bin/python3 (M1/M2 맥북 기준)으로 나온다면 성공적으로 Homebrew 파이썬이 우선순위를 가지고 실행되고 있는 것입니다.
개별 프로젝트마다 다른 파이썬 버전이나 패키지 의존성을 관리해야 할 경우, 파이썬 가상 환경(Virtual Environment)을 적극 활용하는 것이 좋습니다.
python3 -m venv .venv 명령으로 가상 환경을 생성하고 source .venv/bin/activate로 활성화할 수 있습니다. 전 세계 90% 이상의 파이썬 개발자가 이 방식을 사용하며, 개발 환경을 깔끔하게 유지하는 가장 효과적인 방법입니다.
M1/M2 맥북에서 Homebrew를 이용해 파이썬 최신 버전을 설치하는 과정은 생각보다 간단하며, 시스템 파이썬과의 충돌 없이 독립적인 개발 환경을 구축할 수 있습니다. Homebrew 설치부터 파이썬 설치, 그리고 PATH 환경 변수 설정까지 이 글에서 제시한 단계를 따르면 누구나 깔끔하고 효율적인 개발 환경을 갖출 수 있습니다.
지금 바로 적용해 보세요.
- Homebrew 공식 웹사이트 — macOS용 패키지 관리 도구 Homebrew에 대한 상세 정보
- Python 공식 웹사이트 — 파이썬 언어의 최신 정보, 문서 및 다운로드
동영상으로 보는 맥북 파이썬 최신버전 홈브루 설치
글로 충분하지 않다면 관련 영상을 함께 보세요. 클릭하면 YouTube에서 검색 결과로 이동합니다.
자주 묻는 질문
Q. M1/M2 맥에서 파이썬 설치 시 공식 인스톨러나 다른 방법 대신 Homebrew를 사용하는 주된 이유는 무엇인가요?
A. Homebrew는 파이썬을 시스템 파이썬과 충돌하지 않는 독립적인 경로에 설치하여 관리를 단순화합니다. 특히 M1/M2 칩셋에 최적화된 ARM 네이티브 버전을 쉽고 안정적으로 설치할 수 있어, 개발 환경을 깨끗하게 유지하는 데 도움을 줍니다.
Q. Homebrew로 파이썬을 설치하면 macOS 시스템 파이썬이나 기존에 설치된 다른 버전들과의 충돌을 어떻게 방지할 수 있나요?
A. Homebrew는 파이썬을 `/opt/homebrew/bin`과 같은 고유한 독립 디렉토리에 설치하여 시스템 파이썬을 덮어쓰지 않습니다. `PATH` 환경 변수를 올바르게 설정하여 Homebrew 파이썬 경로를 우선시하면, `python3` 명령이 항상 최신 버전을 가리키게 되어 기존 버전과의 충돌 없이 안정적인 환경을 유지할 수 있습니다.
Q. Homebrew를 통해 최신 파이썬 버전을 설치한 후, 실제로 이 버전이 사용되고 있는지 어떻게 확인할 수 있나요?
A. 터미널에서 `which python3` 명령을 실행하면 `/opt/homebrew/bin/python3`와 같은 Homebrew 설치 경로를 확인할 수 있습니다. 이어서 `python3 –version` 명령을 실행하여 설치한 최신 버전 정보가 출력되는지 확인하면 됩니다. 이를 통해 현재 시스템에서 활성화된 파이썬 버전을 명확히 알 수 있습니다.
Q. M1/M2 맥에서 여러 파이썬 버전이 필요하거나 프로젝트별로 다른 버전을 사용해야 할 경우 어떻게 관리하는 것이 좋은가요?
A. Homebrew 자체로도 여러 파이썬 버전을 설치할 수 있지만, 더욱 유연한 버전 관리를 위해서는 `pyenv`와 같은 도구를 함께 사용하는 것을 권장합니다. `pyenv`는 Homebrew로 설치된 파이썬 버전들을 인식하여 프로젝트별로 손쉽게 파이썬 버전을 전환할 수 있도록 도와줍니다. 이를 통해 각각의 프로젝트에 맞는 독립적인 개발 환경을 구축할 수 있습니다.