안녕하세요. 개발 환경을 쾌적하게 구축하는 것은 생산성 향상의 첫걸음입니다. 특히 맥북에서 파이썬(Python)을 설치하고 관리하는 과정은 운영체제(macOS)의 특성상 몇 가지 주의사항이 있습니다. 많은 사용자들은 파이썬의 여러 버전을 효율적으로 관리하고 시스템 안정성을 유지하기 위해 Homebrew(홈브루, brew)라는 패키지 관리자를 사용합니다.
📚 함께 읽으면 좋은 글
이 가이드에서는 2025년 최신 맥북 환경, 특히 M1 또는 M2 칩을 탑재한 Apple Silicon 기반 맥북 사용자들을 포함하여, 가장 빠르고 안정적으로 파이썬 환경을 설정하는 방법을 단계별로 안내합니다. 시스템에 내장된 파이썬 대신 독립적이고 관리하기 쉬운 개발 환경을 구축하는 것이 핵심입니다.
✅ Homebrew(Brew) 설치 및 초기 환경 설정 확인하기
파이썬 설치에 앞서, 맥북 사용자의 필수 패키지 관리 도구인 Homebrew를 먼저 설치해야 합니다. Homebrew는 복잡한 설치 과정을 단일 명령어(brew install)로 단순화시켜줍니다. 2025년 현재, Homebrew는 M1/M2 칩 기반의 Apple Silicon 환경을 완벽하게 지원하며, Rosetta 2 없이 네이티브로 실행됩니다.
Homebrew 설치 상세 더보기
터미널(Terminal)을 열고 아래 명령어를 입력하여 설치를 시작합니다. 설치 과정 중 macOS 로그인 암호를 입력해야 할 수 있으며, Xcode Command Line Tools가 설치되어 있지 않다면 함께 설치를 진행합니다.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"설치가 완료되면, 터미널에 표시되는 지침에 따라 환경 변수(PATH)를 설정해야 합니다. 보통 .zprofile 또는 .bash_profile 파일에 아래와 유사한 내용을 추가하라는 안내가 나옵니다. 이 과정을 완료해야 brew 명령어를 어디서든 사용할 수 있습니다.
맥북 터미널 환경 설정과 ZSH 사용법에 대해 더 알고 싶다면 참고하세요.
환경 변수 설정 후에는 터미널을 새로 시작하거나 아래 명령어로 적용합니다:
source ~/.zshrc # 또는 source ~/.bash_profileHomebrew 설치 확인 및 업데이트 보기
설치가 성공적으로 완료되었는지 확인합니다. 그리고 최신 패키지 정보를 위해 주기적으로 업데이트를 실행하는 것이 좋습니다.
brew doctor # 시스템에 문제가 없는지 확인 brew update # Homebrew 자체 업데이트 brew upgrade # 설치된 모든 패키지 업데이트🐍 맥북 Homebrew를 이용한 파이썬 설치 확인하기
macOS에는 기본적으로 파이썬이 설치되어 있지만, 시스템 운영에 사용되므로 개발용으로 사용하기에는 권장되지 않습니다. Homebrew를 사용하여 독립적인 최신 버전의 파이썬을 설치해야 합니다. 2025년 현재 개발에 가장 널리 사용되는 파이썬 3 버전을 설치하는 것이 일반적입니다.
파이썬 최신 버전 설치 상세 더보기
파이썬 3의 최신 버전을 설치하려면 다음 명령어를 사용합니다. Homebrew는 파이썬 3 버전을 python3 명령어로 등록합니다. Homebrew를 통해 설치하는 것이 macOS 기본 파이썬 환경을 건드리지 않는 가장 좋은 방법입니다.
brew install python파이썬 설치 경로 및 버전 확인 보기
설치가 완료되면, 실제로 어떤 버전의 파이썬이 실행되는지 확인해야 합니다. which 명령어는 현재 사용되는 명령어의 경로를 보여주며, --version 플래그는 버전을 알려줍니다.
which python3 # Homebrew 설치 경로 확인 (예: /opt/homebrew/bin/python3) python3 --version # 설치된 파이썬 버전 확인만약 python 명령어를 사용하고 싶다면, Homebrew로 설치된 파이썬을 심볼릭 링크(Symbolic Link)로 연결할 수 있지만, 일반적으로 python3를 명시적으로 사용하는 것이 혼란을 줄일 수 있습니다. 또한, 파이썬 패키지 관리 도구인 pip도 함께 설치됩니다.
📦 파이썬 패키지 관리 및 가상 환경 설정 확인하기
실제 개발에서는 프로젝트마다 필요한 라이브러리와 파이썬 버전이 다를 수 있습니다. 따라서 전역(Global) 환경에 모든 패키지를 설치하는 대신, 프로젝트별로 독립된 가상 환경(Virtual Environment)을 설정하는 것이 매우 중요합니다.
가상 환경(Virtual Environment) 사용 상세 더보기
파이썬에서 가상 환경을 생성하는 가장 일반적이고 공식적인 방법은 내장 모듈인 venv를 사용하는 것입니다.
1. 프로젝트 폴더로 이동합니다.
cd ~/Documents/MyProject2. 프로젝트 폴더 안에 venv라는 이름의 가상 환경을 생성합니다.
python3 -m venv venv3. 가상 환경을 활성화합니다. 활성화되면 터미널 프롬프트 앞에 가상 환경 이름((venv))이 표시됩니다.
source venv/bin/activate가상 환경이 활성화된 상태에서 pip install 명령어를 사용하면, 해당 프로젝트에만 라이브러리가 설치되어 다른 프로젝트와 충돌을 일으키지 않습니다.
필수 라이브러리 설치 및 비활성화 보기
가상 환경이 활성화된 상태에서 필요한 패키지를 설치합니다. 예를 들어, 웹 개발에 많이 쓰이는 Flask와 데이터 분석에 쓰이는 Pandas를 설치합니다.
pip install flask pandas작업을 마쳤거나 다른 프로젝트로 이동할 때는 다음 명령어로 가상 환경을 비활성화합니다. 이 명령어를 실행하면 다시 시스템의 전역 환경으로 돌아갑니다.
deactivate🔄 여러 파이썬 버전 관리: pyenv 활용 상세 더보기
때로는 특정 프로젝트가 레거시 버전의 파이썬을 요구하거나, 최신 버전의 베타 기능을 테스트해야 하는 경우가 있습니다. Homebrew는 최신 버전을 쉽게 설치해주지만, 여러 버전을 전환하며 관리하는 기능은 pyenv라는 도구가 훨씬 강력합니다. 전문적인 개발 환경에서는 pyenv 사용을 강력히 추천합니다.
pyenv 설치 및 설정 확인하기
Homebrew를 통해 pyenv를 설치합니다.
brew install pyenv설치 후, pyenv가 정상적으로 작동하도록 쉘(Shell) 설정 파일(.zshrc 또는 .bash_profile)에 다음 내용을 추가해야 합니다.
echo 'eval "(pyenv init --path)"' >> ~/.zshrc echo 'eval "(pyenv init -)"' >> ~/.zshrc설정 적용을 위해 터미널을 새로 시작하거나 source 명령어로 적용합니다.
여러 파이썬 버전 설치 및 전환 보기
pyenv install --list 명령어로 설치 가능한 버전을 확인한 후, 원하는 버전을 설치합니다.
pyenv install 3.10.14 # 특정 버전 설치 예시 pyenv install 3.12.1 # 다른 버전 설치 예시버전 전환은 다음과 같이 수행합니다:
- 전역(Global) 버전 설정:
pyenv global 3.12.1(시스템 전체 기본 버전) - 로컬(Local) 버전 설정: 프로젝트 폴더 내에서
pyenv local 3.10.14(해당 폴더에서만 이 버전 사용)
이 방법을 사용하면, 프로젝트 폴더에 들어가는 것만으로도 자동으로 해당 파이썬 버전이 활성화되어 환경 충돌 문제를 완벽하게 해결할 수 있습니다. 2025년 기준, 이 방식은 맥북 개발자들에게 가장 선호되는 방식입니다.
Pyenv와 Virtualenv를 활용한 파이썬 환경 관리에 대한 심층 가이드도 확인해보세요.
💻 2025년 M1/M2 맥북 환경 및 기타 설정 확인하기
Apple Silicon(M1, M2 칩) 기반의 맥북이 일반화되면서, 개발 환경 설정 시 아키텍처(Architecture) 관련 이슈가 거의 사라졌습니다. Homebrew를 포함한 대부분의 개발 도구가 이제 네이티브(Native)로 잘 작동합니다.
M1/M2 칩 환경 고려사항 상세 더보기
과거에는 특정 라이브러리(특히 C/C++ 바인딩이 필요한 NumPy, Matplotlib 같은 과학 컴퓨팅 라이브러리)를 설치할 때 Rosetta 2 에뮬레이션을 통해 인텔(Intel) 버전을 설치해야 하는 경우가 있었습니다. 하지만 2025년에는 대부분의 주요 라이브러리가 Apple Silicon에 최적화된 버전을 제공하므로, pip install 명령어를 실행하면 자동으로 네이티브 버전을 설치합니다. 설치 시 속도가 느리거나 에러가 발생한다면, 해당 라이브러리의 최신 버전을 확인하고 pip를 최신 상태로 유지하세요.
유용한 파이썬 개발 도구 보기
파이썬 개발의 효율성을 높여주는 몇 가지 유용한 도구들을 소개합니다:
| 도구 | 설명 |
|---|---|
| Poetry | 의존성 관리 및 패키징을 위한 도구. venv보다 더 체계적인 프로젝트 관리가 가능합니다. |
| VS Code | 가장 인기 있는 코드 에디터 중 하나. 파이썬 개발을 위한 강력한 확장 기능들을 제공합니다. |
| Jupyter Notebook | 데이터 분석 및 시각화에 필수적인 대화형 컴퓨팅 환경입니다. pip install jupyter로 설치할 수 있습니다. |
📌 추가로 참고할 만한 글
❓ 맥북 파이썬 설치 및 Homebrew 관련 자주 묻는 질문 (FAQ)
Q1: Homebrew로 설치한 파이썬과 macOS에 기본 설치된 파이썬은 어떻게 다른가요?
A: macOS에 기본 설치된 파이썬은 시스템 내부용으로 사용됩니다. 이 버전을 건드리면 macOS의 일부 기능이 오작동할 수 있습니다. Homebrew로 설치한 파이썬은 사용자 계정 내의 독립적인 경로(/opt/homebrew/)에 설치되며, 개발 목적으로 안전하게 사용할 수 있고, 최신 버전 및 다양한 버전을 자유롭게 관리할 수 있습니다.
Q2: M1/M2 맥북에서 Homebrew 설치 시 zsh: command not found: brew 에러가 발생합니다. 어떻게 해결하나요?
A: 이 에러는 Homebrew 설치 후 터미널의 쉘(Shell) 설정 파일(주로 ~/.zshrc 또는 ~/.bash_profile)에 Homebrew의 실행 경로가 환경 변수 PATH에 추가되지 않았거나, 추가 후 터미널이 새로 시작되지 않아서 발생합니다. Homebrew 설치 완료 시 표시된 (echo '...' >> ~/.zshrc) 명령어를 다시 실행하고, 터미널을 완전히 종료 후 다시 시작하거나 source ~/.zshrc 명령어를 실행하여 설정을 적용해야 합니다.
Q3: 파이썬 가상 환경(venv)을 꼭 사용해야 하나요?
A: 네, 강력하게 권장됩니다. 가상 환경은 프로젝트별로 독립적인 파이썬 환경을 제공하여, 각 프로젝트가 서로 다른 버전의 라이브러리를 요구할 때 발생하는 ‘의존성 충돌’을 완벽하게 방지해줍니다. 전역 환경에 모든 것을 설치하면 시간이 지남에 따라 환경이 복잡해지고 관리가 어려워집니다.
Q4: pyenv를 사용하지 않고 단순히 파이썬 버전을 변경하고 싶습니다. 가능한가요?
A: Homebrew는 기본적으로 최신 버전의 파이썬을 설치하며, 다른 버전을 설치하려면 brew install python@3.x 형태로 특정 버전을 명시해야 합니다. 여러 버전을 유기적으로 전환하려면 pyenv가 가장 효율적입니다. 만약 pyenv 없이 특정 버전만 사용하려면, 설치된 버전의 경로를 직접 PATH 환경 변수의 맨 앞에 위치시켜야 하지만, 이 방식은 수동적이고 복잡하여 권장되지 않습니다.
Q5: 파이썬을 삭제하고 싶을 때는 어떻게 해야 하나요?
A: Homebrew로 설치한 파이썬은 간단하게 삭제할 수 있습니다. 삭제 전에 brew list로 정확한 패키지 이름을 확인하고, 다음 명령어를 실행하면 됩니다.
brew uninstall python시스템에 내장된 기본 파이썬은 삭제하지 마세요. 이는 시스템 운영에 필수적인 부분입니다.
이 가이드를 통해 맥북에서 2025년 최신 환경에 맞는 안정적이고 효율적인 파이썬 개발 환경을 구축하시길 바랍니다. 개발 환경을 잘 설정하는 것은 성공적인 프로젝트 수행의 기반이 됩니다.