맥북에 파이썬 최신버전을 설치하려는데 Homebrew로 PATH 설정하다가 기존 시스템 파이썬과 꼬일까 봐 걱정했던 경험, 다들 한 번쯤 있으실 겁니다.
이러한 걱정은 macOS에 기본 탑재된 파이썬 버전과 개발용으로 필요한 최신 파이썬 버전 사이의 환경 변수 충돌 가능성 때문에 생겨납니다.
이 글에서는 Homebrew를 사용하여 맥북에 파이썬 최신버전을 안전하게 설치하고, PATH 설정을 기존 시스템에 전혀 영향을 주지 않으면서 완벽하게 마무리하는 구체적인 방법을 단계별로 안내합니다.
– Homebrew를 통한 맥북 파이썬 최신버전의 안전하고 효율적인 설치 방법을 배웁니다.
– 시스템 파이썬과 충돌 없이 PATH 환경 변수를 정확하게 설정하는 노하우를 얻습니다.
– 개발 프로젝트별로 완벽히 격리된 파이썬 가상 환경을 구축하여 관리 효율을 극대화합니다.
맥북에 파이썬 최신버전을 Homebrew로 설치하여 PATH 오류 없이 손쉽게 환경 설정을 완료하는 방법을 안내합니다.
Homebrew가 맥 파이썬 설치의 표준인 이유
맥북에 파이썬을 설치하는 방법은 다양하지만, 현존하는 가장 추천하는 방식은 Homebrew를 사용하는 것입니다. macOS는 기본적으로 자체 파이썬을 포함하고 있어, 이를 직접 건드릴 경우 시스템 안정성에 문제가 생길 수 있습니다. Homebrew는 이러한 문제없이 독립적인 개발 환경을 구축할 수 있도록 돕는 패키지 관리자입니다.
Homebrew를 사용하면 파이썬 뿐만 아니라 수많은 개발 도구들을 단 한 줄의 명령어로 손쉽게 설치하고 업데이트할 수 있습니다. 예를 들어, `brew install python` 명령 하나면 현재 기준 가장 안정적인 파이썬 3.x 버전을 설치할 수 있으며, 기존 시스템 파이썬과는 완전히 분리되어 관리됩니다.
이는 개발자가 여러 파이썬 버전을 필요로 하거나, 특정 라이브러리 의존성 때문에 충돌이 발생할 위험을 획기적으로 줄여줍니다. 실제로 90% 이상의 맥 개발자들이 Homebrew를 이용해 개발 환경을 구축하고 있으며, 그 편리함과 안정성은 이미 검증되었습니다.
| 구분 | Homebrew 설치 | 수동 설치 (공식 사이트) |
|---|---|---|
| 설치 용이성 | 단순 명령어 `brew install python`으로 5분 내 완료 | 설치 파일 다운로드 후 인스톨러 실행, 추가 환경 설정 필요 |
| 업데이트 관리 | `brew upgrade python`으로 간편하게 최신버전 유지 | 새 버전 나올 때마다 다시 다운로드 및 설치 과정 반복 |
| 시스템 충돌 | 별도 경로 설치로 시스템 파이썬과 완벽 분리, 충돌 위험 없음 | PATH 설정 오류 시 시스템 파이썬과 꼬일 가능성 높음 |
| 환경 관리 | 다른 개발 도구와 함께 일괄 관리 용이 | 파이썬만 관리하며, 다른 도구는 별도로 설치 및 관리 필요 |
Photo by Christina Morillo on Pexels
Homebrew를 통한 파이썬 최신버전 설치 단계
이제 Homebrew를 이용하여 맥북에 파이썬 최신버전을 설치하는 과정을 자세히 살펴보겠습니다. 이 과정은 매우 직관적이며, 대부분의 단계를 터미널에서 단 몇 줄의 명령어로 완료할 수 있습니다. 먼저 Homebrew가 설치되어 있지 않다면 아래 첫 번째 단계부터 시작해주세요.
설치 전, 터미널(Terminal) 앱을 열어 준비해 주십시오. 터미널은 Spotlight 검색(Command + Space)에서 “터미널”을 검색하여 실행할 수 있습니다. 모든 과정은 대략 10분 내외로 충분히 마무리할 수 있습니다.
- Homebrew 설치 (이미 설치되어 있다면 건너뛰기) — 터미널에 다음 명령어를 입력하고 엔터를 누릅니다. 설치 과정에서 비밀번호를 요구할 수 있습니다.
/bin/bash -c “$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)”
- Homebrew 진단 (선택 사항) — 설치가 완료되면 다음 명령어로 Homebrew 환경에 문제가 없는지 확인합니다.
brew doctor
“Your system is ready to brew.” 메시지가 나오면 정상입니다. 경고가 있다면 안내에 따라 조치합니다.
- 파이썬 최신버전 설치 — 드디어 파이썬을 설치할 차례입니다. 다음 명령어를 입력하면 Homebrew가 현재 기준으로 가장 안정적인 파이썬 3.x 버전을 설치합니다.
brew install python
- 설치 확인 — 설치가 완료되면 다음 명령어로 설치된 파이썬 버전을 확인합니다.
python3 –version
예상되는 출력은 `Python 3.12.x`와 같이 Homebrew가 설치한 최신 버전입니다.
Photo by Daniil Komov on Pexels
PATH 설정, 시스템 파이썬과 충돌 없이 안전하게
Homebrew로 파이썬을 설치해도 터미널에서 `python` 또는 `python3` 명령어를 입력했을 때, 여전히 시스템 파이썬이 실행될 수 있습니다. 이는 PATH 환경 변수가 Homebrew 설치 경로를 먼저 찾도록 설정되어 있지 않기 때문입니다. 이 문제를 해결하여 Homebrew 파이썬을 기본으로 사용하면서도 시스템에 영향을 주지 않는 방법을 알려드립니다.
PATH 설정은 쉘(Shell) 설정 파일에 추가하는 방식으로 이루어집니다. 대부분의 최신 macOS는 `zsh` 쉘을 사용하므로 `~/.zshrc` 파일을 수정할 것이며, 혹시 `bash`를 사용한다면 `~/.bash_profile` 또는 `~/.bashrc` 파일을 수정하면 됩니다. 이는 단 한 줄의 설정을 추가하는 간단한 작업입니다.
이 과정을 통해 Homebrew로 설치된 파이썬의 실행 경로를 시스템 경로보다 우선순위로 두어, 터미널에서 `python3` 명령을 입력했을 때 항상 Homebrew 버전이 호출되도록 만듭니다. 동시에 시스템 파이썬은 그대로 유지되어 필요한 경우 언제든 시스템 명령에 의해 사용될 수 있습니다.
PATH를 잘못 설정하면 시스템 명령어가 꼬이거나 예상치 못한 오류가 발생할 수 있습니다. 특히 `export PATH=”<현재 경로>“`와 같이 기존 PATH를 덮어쓰는 대신, `export PATH=”<새로운 경로>:$PATH”`처럼 기존 PATH를 유지하면서 새로운 경로를 앞에 추가하는 것이 중요합니다. 이 글에서 제시하는 방법은 안전한 방식이니 안심하고 따르세요.
- 쉘 설정 파일 열기 — 사용하는 쉘에 따라 다음 명령어로 설정 파일을 엽니다. (대부분 zsh)
vi ~/.zshrc
`vi` 대신 `nano` 에디터를 사용해도 좋습니다. `nano ~/.zshrc`
- PATH 환경 변수 추가 — 파일의 맨 아래에 다음 줄을 추가합니다. Apple Silicon(M1/M2/M3) 맥의 경우 Homebrew 설치 경로가 `/opt/homebrew/bin`입니다. Intel 맥의 경우 `/usr/local/bin`입니다.
# Apple Silicon (M1/M2/M3) 맥 사용자의 경우
export PATH=”/opt/homebrew/bin:$PATH”# Intel 맥 사용자의 경우
export PATH=”/usr/local/bin:$PATH” - 설정 파일 저장 및 적용 — `vi` 에디터의 경우 `esc` 키를 누른 후 `:wq`를 입력하고 엔터를 누릅니다. `nano` 에디터의 경우 `Ctrl+X`를 누른 후 `Y`를 입력하고 엔터를 누릅니다. 그 다음 터미널에 다음 명령어를 입력하여 변경 사항을 적용합니다.
source ~/.zshrc
- PATH 확인 — 이제 다음 명령어로 PATH 설정을 확인합니다. Homebrew 파이썬 경로가 가장 앞에 나와야 합니다.
echo $PATH
- 파이썬 버전 재확인 — 마지막으로 `python3 –version` 명령어를 다시 입력하여 Homebrew로 설치된 최신 파이썬 버전이 출력되는지 확인합니다.
Photo by Oluwaseun Duncan on Pexels
가상 환경(venv)으로 파이썬 프로젝트 관리
파이썬 개발에서 가장 중요한 관행 중 하나는 ‘가상 환경(Virtual Environment)’을 사용하는 것입니다. 가상 환경은 각 프로젝트마다 독립적인 파이썬 환경을 제공하여, 프로젝트 A에서 사용하는 라이브러리와 프로젝트 B에서 사용하는 라이브러리가 서로 충돌하는 일을 방지합니다. Homebrew로 최신 파이썬을 설치했다면, 이제 `venv` 모듈을 활용하여 가상 환경을 구축할 수 있습니다.
가상 환경을 사용하면 특정 프로젝트를 위해 설치한 패키지들이 시스템 파이썬이나 다른 프로젝트의 파이썬 환경에 영향을 주지 않습니다. 예를 들어, 웹 개발 프로젝트에는 Django 4.2를 사용하고, 데이터 분석 프로젝트에는 Pandas 2.0을 사용해야 한다고 가정해 봅시다. 가상 환경을 사용하면 이 두 요구사항을 완벽하게 분리하여 관리할 수 있습니다.
이는 장기적인 개발 과정에서 발생할 수 있는 의존성 문제를 99% 이상 해결해 주며, 협업 시에도 각자의 개발 환경을 쉽게 공유하고 재현할 수 있게 합니다. 지금부터 시작하는 모든 파이썬 프로젝트는 가상 환경 내에서 진행하는 것을 습관화하는 것이 좋습니다.
가상 환경은 프로젝트 폴더 내부에 생성하는 것이 일반적입니다. 이렇게 하면 프로젝트를 다른 컴퓨터로 옮기거나 Git으로 관리할 때도 가상 환경의 경로를 쉽게 추적할 수 있습니다. 가상 환경을 생성할 때는 `.gitignore` 파일에 가상 환경 폴더 이름을 추가하여 불필요하게 버전 관리되지 않도록 하는 것이 좋습니다.
- 프로젝트 디렉토리 생성 및 이동 — 먼저 프로젝트를 위한 폴더를 만들고 그 안으로 이동합니다.
mkdir my_python_project
cd my_python_project - 가상 환경 생성 — 프로젝트 폴더 내에서 `venv`를 사용하여 가상 환경을 생성합니다. 일반적으로 가상 환경 폴더 이름은 `venv` 또는 `.venv`로 지정합니다.
python3 -m venv venv
- 가상 환경 활성화 — 생성된 가상 환경을 활성화합니다.
source venv/bin/activate
활성화되면 터미널 프롬프트 앞에 `(venv)`와 같은 표시가 나타나, 현재 가상 환경이 활성화되었음을 알려줍니다.
- 패키지 설치 및 사용 — 이제 필요한 파이썬 패키지들을 이 가상 환경 안에 설치할 수 있습니다.
pip install requests
- 가상 환경 비활성화 — 프로젝트 작업을 마치면 가상 환경을 비활성화합니다.
deactivate
맥북에서 파이썬 최신버전을 설치하고 관리하는 것은 Homebrew와 가상 환경을 통해 간단하고 안전하게 이루어질 수 있습니다. 시스템 파이썬과의 충돌 걱정 없이 개발 환경을 구축하고, 프로젝트별로 독립적인 환경을 관리하는 습관을 들이는 것이 중요합니다.
지금 바로 적용해 보세요.
- Homebrew 공식 웹사이트 — macOS용 패키지 관리자 Homebrew의 공식 문서입니다.
- Python macOS 다운로드 — 파이썬 공식 웹사이트의 macOS용 파이썬 다운로드 정보입니다.
- venv – Creation of virtual environments — 파이썬 공식 문서의 가상 환경(venv) 생성 및 사용법 안내입니다.
동영상으로 보는 맥 파이썬 최신버전 Homebrew 설치
글로 충분하지 않다면 관련 영상을 함께 보세요. 클릭하면 YouTube에서 검색 결과로 이동합니다.
자주 묻는 질문
Q. 맥북에 파이썬을 설치할 때 왜 Homebrew를 사용하는 것이 좋은가요?
A. Homebrew는 맥에서 소프트웨어 설치 및 관리를 쉽게 해주는 패키지 관리자입니다. 시스템 파이썬과의 충돌을 피하고, 최신 버전을 쉽게 설치하며, PATH 설정 오류를 최소화하여 개발 환경을 깔끔하게 유지하는 데 큰 장점이 있습니다.
Q. 이미 맥에 파이썬이 설치되어 있는데, Homebrew로 또 설치해도 문제가 없나요?
A. 네, Homebrew로 파이썬을 설치하는 것은 기존 시스템 파이썬이나 다른 파이썬 설치와 충돌하지 않습니다. Homebrew는 별도의 경로에 설치되므로, 이 가이드에서 PATH 설정을 올바르게 하면 최신 Homebrew 파이썬을 우선적으로 사용할 수 있게 됩니다.
Q. 파이썬 설치 후, 최신 버전이 잘 설치되었고 PATH 설정이 올바른지 어떻게 확인할 수 있나요?
A. 설치를 마친 후 새 터미널을 열고 `python3 –version` 명령어로 설치된 파이썬의 버전을 확인하세요. 또한 `which python3` 명령어를 통해 실행되는 파이썬의 경로가 Homebrew가 관리하는 경로(예: `/opt/homebrew/bin/python3`)인지 확인하여 올바른 PATH 설정을 검증할 수 있습니다.
Q. 맥에서 파이썬 PATH 오류가 자주 발생한다고 하는데, Homebrew가 어떻게 이를 방지해주나요?
A. PATH 오류는 주로 터미널이 시스템 파이썬 같은 원치 않는 버전을 찾거나, 새로 설치한 파이썬을 찾지 못할 때 발생합니다. Homebrew는 파이썬을 예측 가능한 표준 경로에 설치하고 PATH 설정을 위한 지침을 제공하여, 사용자가 올바른 버전을 우선적으로 참조하도록 도와 이런 오류를 효과적으로 방지합니다.
📚 함께 읽으면 좋은 글