M1/M2 맥 파이썬 최신버전 설치 어려울 때 — 홈브루로 한방 해결

M1/M2 맥북에 파이썬 최신 버전을 설치하려니 기존 파이썬 버전과의 충돌이 걱정되고, 수많은 방법 중 어떤 것이 가장 안정적이고 깔끔한지 몰라 막막하셨을 겁니다.

이는 macOS에 기본 설치된 파이썬 버전과 사용자가 필요에 의해 설치하는 파이썬 버전, 그리고 다양한 개발 도구들이 복잡하게 얽히면서 발생하는 흔한 문제입니다.

이 글에서는 M1/M2 맥 환경에서 홈브루를 이용해 파이썬 최신 버전을 빠르고 안정적으로 설치하고 관리하는 방법을 4단계로 상세히 설명하여, 더 이상 버전 충돌 걱정 없이 개발에만 집중할 수 있도록 돕겠습니다.

왜 M1/M2 맥에서 파이썬 설치가 복잡하게 느껴질까?

M1/M2 맥을 포함한 macOS 환경은 기본적으로 자체적인 파이썬 2.x 또는 3.x 버전을 내장하고 있습니다. 이 시스템 파이썬은 macOS의 내부 동작과 관련된 중요한 스크립트들을 구동하는 데 사용되기 때문에, 사용자가 임의로 삭제하거나 버전을 변경할 경우 시스템 오류를 유발할 수 있습니다. 바로 이 지점에서 첫 번째 복잡성이 시작됩니다.

여기에 사용자가 최신 파이썬 버전을 설치하려 할 때, 공식 웹사이트에서 다운로드한 인스톨러나 Anaconda와 같은 배포판을 사용하게 됩니다. 이 방식들은 각기 다른 경로에 파이썬을 설치하며, 종종 환경 변수 설정에 혼란을 주어 ‘내가 실행하는 파이썬이 과연 어떤 버전인지’ 명확히 알기 어렵게 만듭니다. 이 때문에 ‘파이썬이 분명 설치되었는데 작동하지 않는다’는 문제가 빈번히 발생합니다.

이러한 복잡성은 개발 프로젝트마다 다른 파이썬 버전을 요구할 때 더욱 심화됩니다. 시스템 파이썬은 건드리지 않으면서, 프로젝트 A는 파이썬 3.9를, 프로젝트 B는 파이썬 3.11을 사용해야 하는 상황에서 수동으로 경로를 설정하고 관리하는 것은 매우 번거롭고 실수할 확률이 높습니다.

Photo by Mikael Monjour on Pexels

홈브루(Homebrew)로 파이썬 설치, 가장 깔끔한 이유

홈브루는 macOS를 위한 강력한 패키지 관리자로, 맥 사용자라면 필수적으로 설치해야 하는 도구 중 하나입니다. 리눅스의 apt나 yum과 유사하게, 터미널 명령 한 줄로 원하는 소프트웨어를 설치, 업데이트, 삭제할 수 있도록 돕습니다. 파이썬 설치 역시 홈브루의 가장 큰 장점 중 하나로 꼽힙니다.

홈브루를 통해 파이썬을 설치하면, 시스템에 내장된 파이썬과 완전히 독립적인 경로에 설치됩니다. 예를 들어, 시스템 파이썬이 `/usr/bin/python3`에 있다면, 홈브루로 설치한 파이썬은 `/opt/homebrew/bin/python3` (M1/M2 맥 기준)에 위치하게 됩니다. 이는 경로 충돌을 원천적으로 방지하고, 각 파이썬 버전을 명확하게 분리하여 관리할 수 있게 해줍니다.

또한, 홈브루는 파이썬 설치 시 필요한 모든 의존성 라이브러리들을 자동으로 함께 설치해줍니다. 수동 설치 과정에서 누락될 수 있는 부분들을 홈브루가 알아서 처리해주기 때문에, 사용자는 ‘설치’ 명령만 내리면 복잡한 과정 없이 바로 파이썬을 사용할 수 있게 됩니다. M1/M2 칩셋에 최적화된 바이너리로 설치되어 성능 면에서도 이점을 가집니다.

M1/M2 맥북에 파이썬 최신버전 설치 4단계

이제 홈브루를 이용해 M1/M2 맥북에 파이썬 최신 버전을 설치하는 구체적인 4단계를 살펴보겠습니다. 터미널을 열고 아래 명령어를 순서대로 따라오시면 됩니다.

1. 홈브루 설치 (아직 없는 경우) — 맥북에 홈브루가 설치되어 있지 않다면, 다음 명령어로 설치합니다. 이 과정은 시스템 환경에 따라 2~5분 정도 소요될 수 있습니다.
   `curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh | bash`

   설치 완료 후 터미널에 표시되는 지시에 따라 환경 변수 설정을 완료해주세요. 대부분은 다음과 같은 명령어를 실행해야 합니다.
   `echo ‘eval “$(/opt/homebrew/bin/brew shellenv)”‘ >> ~/.zprofile`
   `eval “$(/opt/homebrew/bin/brew shellenv)”`

2. 파이썬 최신 버전 설치 — 홈브루가 준비되었다면, 이제 파이썬 최신 버전을 설치할 차례입니다. 홈브루는 기본적으로 `python3` 명령어를 통해 가장 안정적인 최신 파이썬 3.x 버전을 설치해줍니다.
   `brew install python3`

   이 명령어를 실행하면 필요한 의존성과 함께 파이썬 최신 버전이 설치됩니다. 설치 후에는 `python3 –version` 명령어로 설치된 파이썬 버전을 확인할 수 있습니다. 예를 들어 `Python 3.11.5`와 같이 나타날 것입니다.

3. 기본 파이썬 설정 확인 — 홈브루로 설치된 파이썬이 시스템 기본 파이썬보다 우선순위를 가지도록 환경 변수가 올바르게 설정되었는지 확인하는 것이 중요합니다. 주로 `.zprofile` 또는 `.bash_profile` 파일에 홈브루 경로가 시스템 PATH보다 먼저 오도록 설정되어 있을 것입니다.
   `which python3`

   이 명령을 실행했을 때 `/opt/homebrew/bin/python3` (M1/M2 맥)과 같은 홈브루 경로가 나오면 성공적으로 설정된 것입니다. 만약 다른 경로가 나온다면, 환경 변수 설정을 다시 확인해야 합니다.

4. 가상 환경 구성 (선택 사항이지만 강력 권장) — 파이썬 프로젝트를 진행할 때는 각 프로젝트마다 독립적인 가상 환경(Virtual Environment)을 사용하는 것이 좋습니다. 이는 프로젝트별로 필요한 라이브러리들을 격리하여 관리하고, 버전 충돌을 방지하는 가장 효과적인 방법입니다. 아래는 `venv` 모듈을 이용한 가상 환경 생성 및 활성화 예시입니다.
   `mkdir my_python_project`
   `cd my_python_project`
   `python3 -m venv .venv`
   `source .venv/bin/activate`

   가상 환경이 활성화되면 터미널 프롬프트 앞에 `(.venv)`와 같은 표시가 나타납니다. 이제 이 환경에서 `pip install`로 라이브러리를 설치하면, 해당 프로젝트에만 종속됩니다.

파이썬 버전 관리 및 문제 해결 팁

홈브루를 통해 파이썬을 설치하면 버전 관리가 매우 쉬워집니다. 예를 들어, 파이썬 최신 버전이 업데이트되었을 때 `brew upgrade python3` 명령 한 줄로 간편하게 업데이트할 수 있습니다. 특정 마이너 버전(예: Python 3.9)을 설치해야 한다면 `brew install python@3.9`와 같이 설치하고, `brew link python@3.9 –force –overwrite` 명령어로 해당 버전을 활성화할 수도 있습니다.

만약 `python` 또는 `python3` 명령어가 예상과 다른 버전을 가리키거나, ‘command not found’ 오류가 계속 발생한다면, 가장 먼저 환경 변수(PATH) 설정을 점검해야 합니다. 터미널의 설정 파일(`.zprofile`, `.bash_profile` 등)을 열어 `/opt/homebrew/bin` 경로가 다른 파이썬 경로보다 먼저 위치하는지 확인하세요. `echo $PATH` 명령어로 현재 PATH 환경 변수를 출력하여 우선순위를 볼 수 있습니다.

파이썬 프로젝트를 시작할 때 가상 환경을 사용하는 습관을 들이는 것이 가장 중요합니다. 위에서 설명한 `venv`를 활용하면 전역 파이썬 환경을 오염시키지 않고 수백 개의 프로젝트를 안정적으로 관리할 수 있습니다. 이는 파이썬 개발의 기본 중 80% 이상을 차지하는 중요한 원칙입니다.