[환경 설정 - 3] macOS에서 .zshrc 파일로 Python 경로 설정하기

macOS에서 Python을 설치한 후, 터미널에서 python3 --version을 실행했을 때 설치한 버전이 아니라 기본적으로 내장된 파이썬 버전이 출력된 경험이 있나요? 이런 문제는 macOS에 기본적으로 설치된 파이썬이 경로 우선순위에 있기 때문에 발생합니다. 이를 해결하려면 .zshrc 파일을 사용해 Python 경로를 직접 설정해야 합니다. 이번 포스팅에서는 이런 상황의 원인을 분석하고 .zshrc 파일을 활용한 해결 방법을 자세히 설명합니다.

---

1. 문제의 원인: macOS 기본 파이썬 버전

 

macOS는 시스템 유틸리티와 호환성을 위해 기본 파이썬(Python 2.x 또는 3.x)을 설치한 상태로 제공됩니다.

• 기본 파이썬은 /usr/bin/python3에 위치하며, 시스템 경로(PATH)의 우선순위가 높게 설정되어 있습니다.

• 사용자가 Homebrew, Pyenv 등으로 최신 파이썬을 설치해도 PATH 설정이 제대로 되어 있지 않으면 기본 파이썬이 우선 실행됩니다.

---

2. 해결 방법: .zshrc 파일로 경로 설정

 

Python 설치 경로를 명시적으로 설정하면 사용자가 설치한 파이썬 버전을 우선적으로 사용할 수 있습니다. 아래는 .zshrc 파일을 활용한 단계별 해결 방법입니다.

---

2.1 Python 설치 경로 확인

 

우선, 사용자가 설치한 파이썬의 경로를 확인합니다.

Homebrew로 설치한 경우, 기본적으로 /opt/homebrew/bin/python3에 위치합니다.

 

설치된 파이썬 경로 찾기

 

터미널에서 다음 명령어를 실행하세요:

which python3

 

결과 예시:

/opt/homebrew/bin/python3

---

2.2 .zshrc 파일 수정

 

이제 .zshrc 파일에 Python 경로를 추가합니다.

 

1) .zshrc 파일 열기

vim ~/.zshrc

 

2) Python 경로 추가

 

파일에 다음 내용을 추가합니다:

# Python 경로 설정
export PATH="/opt/homebrew/bin:$PATH"

 

3) 저장 후 설정 적용

 

.zshrc 파일을 저장하고, 설정을 터미널에 적용합니다.

source ~/.zshrc

---

반응형

---

2.3 Python 버전 확인

 

설정을 적용한 후, 올바른 버전이 출력되는지 확인합니다.

python3 --version

 

결과 예시:

Python 3.13.0

---

3. 추가 팁: 기본 Python을 완전히 대체해야 할까?

 

macOS의 기본 파이썬은 일부 시스템 유틸리티에 사용되기 때문에 삭제하거나 변경하지 않는 것이 좋습니다. 대신, PATH 설정을 통해 사용자가 설치한 Python을 우선순위에 두는 것이 가장 안전한 방법입니다.

---

4. 마무리

 

macOS에서 Python 버전이 제대로 나오지 않는 문제는 경로 설정만으로 쉽게 해결할 수 있습니다. .zshrc 파일을 활용하면 Python뿐만 아니라 Node.js, Java 등 다른 도구의 경로도 효율적으로 관리할 수 있습니다. 이번 포스팅을 참고해 자신의 개발 환경을 최적화해 보세요!