새 파이썬 프로젝트를 시작하려고 맥북 M1/M2에 최신 버전을 설치했는데, 기존 시스템 파이썬과 꼬일까 봐 걱정되시죠?
macOS는 기본적으로 파이썬 버전을 내장하고 있어, 별도로 설치한 파이썬과 시스템 파이썬의 경로가 겹쳐 예상치 못한 오류를 일으키는 경우가 많습니다.
이 글에서는 맥북 M1/M2 환경에서 Homebrew를 이용해 파이썬 최신 버전을 안전하게 설치하고 관리하며, 환경 충돌을 완벽하게 방지하는 구체적인 방법을 단계별로 안내합니다.
– Homebrew를 통한 파이썬 설치는 시스템 파이썬과의 독립적인 환경을 제공하여 충돌을 원천적으로 방지합니다.
– M1/M2 맥에 최적화된 Homebrew 설치를 통해 파이썬 최신 버전을 빠르고 안정적으로 구축할 수 있습니다.
– PATH 설정과 가상 환경 활용은 여러 프로젝트에서 다양한 파이썬 버전을 유연하게 관리하는 핵심 전략입니다.
맥북에서 파이썬 설치 후 충돌이 발생하면 최신 Homebrew를 이용해 M1/M2 칩 환경에서도 쉽게 해결할 수 있습니다.
왜 Homebrew로 파이썬을 설치해야 할까요?
맥북 사용자라면 한 번쯤 시스템 파이썬과 새로 설치한 파이썬 버전 사이의 혼란을 겪어본 경험이 있을 것입니다. macOS에 기본으로 내장된 파이썬은 시스템의 내부 작동에 사용되므로, 개발자가 임의로 버전을 변경하거나 패키지를 설치하면 시스템 안정성에 문제가 생길 수 있습니다. 특히 M1/M2 칩 기반의 최신 맥 환경에서는 이러한 관리의 중요성이 더욱 커집니다.
이러한 문제를 해결하기 위한 가장 강력하고 안정적인 방법이 바로 Homebrew를 사용하는 것입니다. Homebrew는 맥 운영체제용 패키지 관리자로, 수많은 개발자들이 의존하는 핵심 도구입니다. Homebrew를 통해 파이썬을 설치하면 시스템 파이썬과 완전히 분리된 경로에 설치되어, 환경 충돌 걱정 없이 원하는 최신 버전을 자유롭게 사용할 수 있습니다. 실제로 90% 이상의 맥 개발자들이 Homebrew를 선호하며 개발 환경을 구축하고 있습니다.
M1/M2 맥에 Homebrew 설치하기 (혹은 확인하기)
Homebrew가 이미 설치되어 있는지 확인하는 것부터 시작합니다. 터미널을 열고 다음 명령어를 입력해 보세요. 만약 Homebrew가 설치되어 있다면 버전 정보가 출력될 것입니다.
brew --version
만약 명령어를 찾을 수 없다는 메시지가 나오거나 설치가 되어 있지 않다면, Homebrew를 설치해야 합니다. M1/M2 맥에서는 ARM 아키텍처에 최적화된 설치가 중요합니다. 아래의 공식 설치 스크립트를 터미널에 붙여넣고 실행하면, 대략 2분 내외로 설치가 완료됩니다.
- 설치 스크립트 실행 — 다음 명령어를 터미널에 붙여넣고 실행합니다.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 설치 안내 따르기 — 비밀번호를 입력하라는 메시지가 나오면 맥북 잠금 해제 비밀번호를 입력하고, 추가로 설치가 필요한 경우 Enter를 눌러 진행합니다.
- 환경 변수 설정 확인 — 설치 완료 후 터미널에 출력되는 다음 두 줄의 명령어를 복사하여 실행합니다. 이는 Homebrew가 올바르게 작동하도록 PATH 환경 변수를 설정하는 과정입니다.
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofileeval "$(/opt/homebrew/bin/brew shellenv)"
이후 brew doctor 명령어를 실행하여 모든 설정이 올바르게 완료되었는지 최종적으로 확인하는 것이 좋습니다.
Homebrew로 파이썬 최신 버전 설치 및 환경 설정
이제 Homebrew를 이용해 파이썬 최신 버전을 설치할 차례입니다. Homebrew는 기본적으로 현재 가장 안정적인 최신 파이썬 버전을 제공합니다. 다음 간단한 명령어로 설치를 시작할 수 있습니다.
- 파이썬 설치 — 터미널에 아래 명령어를 입력하여 파이썬 3을 설치합니다.
brew install python이 명령어는 최신 파이썬 3 버전을 설치하며, 동시에 pip와 setuptools 등의 필수 도구도 함께 설치합니다.
- 설치 확인 — 설치가 완료되면 다음 명령어로 파이썬 버전을 확인합니다.
python3 --version이때 출력되는 버전이 방금 Homebrew로 설치한 최신 버전인지 확인해야 합니다. 만약 시스템 파이썬(Python 2.x 또는 구형 Python 3.x)이 출력되거나 명령어를 찾을 수 없다는 메시지가 나온다면 PATH 설정에 문제가 있을 수 있습니다.
- PATH 환경 변수 설정 — Homebrew로 설치한 파이썬이 시스템 PATH에서 우선순위를 갖도록 설정해야 합니다. Homebrew는 파이썬을
/opt/homebrew/bin경로에 설치하므로, 이 경로를 `.zprofile` (zsh 셸의 경우) 또는 `.bash_profile` (bash 셸의 경우) 파일에 추가해야 합니다.echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zprofile위 명령어를 실행한 후 터미널을 다시 시작하거나
source ~/.zprofile(또는 해당 셸 프로파일) 명령어를 실행하여 변경사항을 적용합니다.
본인의 셸 환경(zsh, bash 등)에 맞춰 `.zprofile` 또는 `.bash_profile` 파일에 PATH를 추가해야 합니다. M1/M2 맥의 기본 셸은 zsh이므로 `.zprofile`에 추가하는 것이 일반적입니다. 이미 다른 PATH 설정이 있다면 중복되지 않도록 주의하세요.
이제 which python3 명령어를 입력했을 때 /opt/homebrew/bin/python3가 출력되어야 합니다. 이는 Homebrew로 설치한 파이썬이 올바르게 우선순위를 가지고 있음을 의미합니다.
파이썬 가상 환경으로 프로젝트 독립성 확보
Homebrew로 파이썬 최신 버전을 성공적으로 설치했더라도, 여러 파이썬 프로젝트를 동시에 진행할 때는 “가상 환경”을 사용하는 것이 필수적입니다. 가상 환경은 각 프로젝트마다 독립적인 파이썬 환경을 제공하여, 필요한 패키지를 개별적으로 설치하고 관리할 수 있게 해줍니다. 이는 전역 파이썬 환경의 오염을 방지하고, 프로젝트 간의 의존성 충돌을 막아줍니다.
- 가상 환경 생성 — 프로젝트 폴더로 이동한 후, 다음 명령어로 가상 환경을 생성합니다. 여기서는 `venv`라는 이름의 가상 환경을 생성합니다.
python3 -m venv venvvenv는 가상 환경 이름이며, 원하는 다른 이름으로 변경해도 좋습니다. - 가상 환경 활성화 — 생성된 가상 환경을 활성화하려면 다음 명령어를 사용합니다.
source venv/bin/activate터미널 프롬프트 앞에
(venv)와 같이 가상 환경 이름이 표시되면 성공적으로 활성화된 것입니다. - 패키지 설치 및 사용 — 가상 환경이 활성화된 상태에서
pip install명령어로 패키지를 설치하면, 해당 패키지는 현재 활성화된 가상 환경에만 설치되어 프로젝트에 독립적으로 사용됩니다.pip install numpy - 가상 환경 비활성화 — 프로젝트 작업을 마친 후 가상 환경을 비활성화하려면 다음 명령어를 입력합니다.
deactivate
파이썬 3.3 버전부터는 가상 환경 생성을 위해
venv 모듈이 기본적으로 포함되어 있어 별도의 설치가 필요 없습니다. 이전에는 virtualenv 패키지를 별도로 설치해야 했지만, 이제는 python3 -m venv를 사용하는 것이 권장됩니다.
각 프로젝트마다 고유한 가상 환경을 만들고 사용하면, 파이썬 버전 충돌이나 패키지 의존성 문제로부터 완전히 자유로워질 수 있습니다. 이는 안정적인 개발 환경을 유지하는 가장 현명한 방법 중 하나입니다.
맥북 M1/M2 환경에서 파이썬 최신 버전을 안전하게 사용하기 위한 핵심은 Homebrew를 통한 설치와 가상 환경의 활용입니다. Homebrew는 시스템 파이썬과의 충돌을 방지하고 효율적인 패키지 관리를 가능하게 하며, 가상 환경은 각 프로젝트의 독립성을 보장하여 복잡한 의존성 문제를 해결해 줍니다.
이 가이드를 통해 최적의 파이썬 개발 환경을 구축하고, 어떠한 충돌 걱정 없이 프로젝트에 집중하시길 바랍니다. 지금 바로 적용해 보세요.
- Homebrew 공식 웹사이트 (한국어) — Homebrew 설치 및 사용에 대한 공식 문서입니다.
- Python venv — 가상 환경 생성 및 관리 — 파이썬 공식 문서에서 venv 모듈 사용법에 대해 자세히 설명합니다.
동영상으로 보는 맥북 파이썬 최신버전 Homebrew 설치 M1/M2
글로 충분하지 않다면 관련 영상을 함께 보세요. 클릭하면 YouTube에서 검색 결과로 이동합니다.
자주 묻는 질문
Q. 맥북에서 파이썬 설치 시 충돌이 자주 발생하는 이유는 무엇인가요?
A. 맥OS에는 기본 시스템 파이썬이 내장되어 있어, 사용자가 다른 방법으로 새 파이썬 버전을 설치할 때 경로(PATH) 충돌이 발생할 수 있습니다. 특히 M1/M2 맥은 Rosetta와 네이티브 ARM 환경이 섞일 경우 더욱 복잡한 문제로 이어지기 쉽습니다.
Q. Homebrew는 무엇이며, 맥북 파이썬 설치에 왜 추천되나요?
A. Homebrew는 macOS용 패키지 관리자로, 소프트웨어 설치를 간편하게 돕습니다. 시스템 파이썬과 독립적으로 다양한 파이썬 버전을 깔끔하게 설치하고 관리할 수 있어, 개발 환경 충돌을 방지하고 여러 프로젝트에 맞는 버전을 쉽게 전환할 수 있게 해줍니다.
Q. M1/M2 맥북에서 Homebrew로 파이썬 최신 버전을 올바르게 설치하는 방법은 무엇인가요?
A. 먼저 `brew update`로 Homebrew를 최신 상태로 유지하세요. M1/M2 맥에서는 Homebrew가 `/opt/homebrew` 경로에 네이티브 ARM 버전으로 설치되었는지 확인 후 `brew install python@3.x` 명령어를 사용하면 됩니다. 이렇게 하면 시스템에 영향을 주지 않고 최신 파이썬 버전을 안정적으로 설치할 수 있습니다.
Q. Homebrew로 파이썬을 설치했는데 터미널에서 여전히 이전 버전이 실행됩니다. 어떻게 해야 하나요?
A. 이는 쉘의 PATH 환경 변수가 Homebrew 파이썬 경로를 제대로 인식하지 못하기 때문입니다. `~/.zshrc` 또는 `~/.bash_profile` 같은 쉘 설정 파일에 Homebrew의 bin 경로(예: `/opt/homebrew/bin`)가 PATH의 가장 앞에 오도록 추가해야 합니다. 파일 수정 후에는 터미널을 다시 시작하거나 `source` 명령으로 변경 사항을 적용해 주세요.
함께 읽으면 좋은 글