Mac에서 Python 3.10 설치 및 가상환경 세팅하기

이 글에서는 Mac(macOS)에서 Python 3.10을 설치하고, 가상환경을 세팅하는 방법

파이썬 공식 설치 파일, Homebrew, pyenv 등 다양한 설치 방법과, venv로 프로젝트별 가상환경을 깔끔하게 분리하는 방법을 예제로 설명합니다.

---

1. Python 3.10 설치 방법

1-1. 공식 사이트 설치 (가장 쉬운 방법)

1. Python 공식 사이트에 방문합니다.
2. 최신 macOS 64-bit installer(예시: python-3.10.12-macos11.pkg)를 다운로드합니다.
3. 다운받은 파일을 실행하고, Install 또는 계속(Continue)를 눌러 안내에 따라 설치합니다.
4. 설치가 끝나면 터미널을 열어 아래 명령으로 설치 확인:
5. python3 --version # 또는 python3.10 --version

출력 예:

Python 3.10.12

• 참고: python --version은 Mac의 기본 python2를 보여줄 수 있으므로 항상 python3 혹은 python3.10을 사용하세요.

1-2. Homebrew로 설치 (권장)

• Homebrew가 없다면 공식 설치 가이드 참고 후 먼저 설치하세요.
• 아래 명령어로 Python 3.10을 설치할 수 있습니다:

brew install python@3.10

• 설치 후, PATH를 추가해줍니다:

echo 'export PATH="/opt/homebrew/opt/python@3.10/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

• 버전 확인:

python3.10 --version

1-3. pyenv로 설치 (파이썬 버전 관리에 유용)

• 여러 파이썬 버전을 쓸 계획이라면 pyenv가 편리합니다.
• 설치:

brew install pyenv pyenv-virtualenv

• pyenv로 Python 3.10 설치 및 사용 지정:

pyenv install 3.10.12
pyenv global 3.10.12

• 터미널에 적용 후 사용:

exec "$SHELL"
python --version  # pyenv 적용 버전 확인

---

2. 가상환경(venv) 세팅 방법

2-1. venv로 가상환경 만들기 (프로젝트별 권장)

macOS는 파이썬 표준 라이브러리로 venv를 제공합니다. 원하는 폴더(예: 프로젝트 폴더)에서 아래처럼 입력하세요.

# 1. 프로젝트 폴더로 이동
cd ~/myproject

# 2. 가상환경 생성 (3.10 버전 명시)
python3.10 -m venv .venv

# 3. 가상환경 활성화
source .venv/bin/activate

# (가상환경이 활성화되면 프롬프트에 (.venv) 표시)

# 4. 필요한 패키지 설치
pip install requests

• 가상환경을 끄려면(비활성화):

deactivate

2-2. pyenv-virtualenv로 가상환경 만들기 (여러 버전 관리 시)

• 가상환경 생성:

pyenv virtualenv 3.10.12 myenv310

• 활성화:

pyenv activate myenv310

• 비활성화:

pyenv deactivate

---

3. 실전 팁 & 주의사항

• 가상환경 이름은 보통 .venv 또는 env 등으로 지정하는 것이 관례입니다.
• 파이썬 실행 시: 항상 패스를 명확히 입력하세요. python3, python3.10 등.
• 패키지 관리:
  • 설치 패키지 목록 저장: pip freeze > requirements.txt
  • 목록으로 재설치: pip install -r requirements.txt

---

4. 요약 정리

1. 공식사이트나 Homebrew, pyenv로 Python 3.10 설치
2. python3.10 -m venv .venv로 가상환경 생성 후 source .venv/bin/activate로 활성화
3. 프로젝트마다 독립된 환경에서 개발 → 의존성 충돌 방지

---