Mac에서 Python 경로(PYTHONPATH) 설정하는 방법

Mac에서 PYTHONPATH 설정하기

Mac OS에서 Python이 모듈과 패키지를 임포트할 때 다른 디렉터리도 검색하도록 하려면 PYTHONPATH 환경 변수를 내보내면 됩니다.

기본 설정 방법

터미널에서 아래 명령어를 실행하세요:

$ export PYTHONPATH=${PYTHONPATH}:${HOME}/foo

위 예시는 홈 디렉터리 아래의 foo 폴더를 PYTHONPATH에 추가하는 경우입니다. 여기서 중요한 점은 기존 PYTHONPATH 값을 덮어쓰는 것이 아니라, 콜론(:)을 이용해 뒤에 추가(append)한다는 것입니다. 만약 기존 값을 대체해버리면, 원래 설정되어 있던 모듈 검색 경로들이 사라져 예상치 못한 오류가 발생할 수 있습니다.

설정 확인하기

환경 변수가 제대로 등록되었는지 확인하려면 다음 명령어를 사용합니다:

$ echo $PYTHONPATH

또는 Python 인터프리터 안에서 실제 모듈 검색 경로를 직접 확인할 수도 있습니다:

>>> import sys
>>> print(sys.path)

설정을 영구적으로 유지하려면

export 명령은 현재 터미널 세션에서만 유효하며, 터미널을 닫으면 사라집니다. 설정을 영구적으로 적용하려면 셸 설정 파일에 해당 명령을 추가해야 합니다.

• zsh 사용 시(macOS Catalina 이상 기본): ~/.zshrc 파일에 추가
• bash 사용 시: ~/.bash_profile 또는 ~/.bashrc 파일에 추가

$ echo 'export PYTHONPATH=${PYTHONPATH}:${HOME}/foo' >> ~/.zshrc
$ source ~/.zshrc

주의사항

대부분의 경우 PYTHONPATH를 직접 수정하는 것은 권장되지 않습니다. 잘못된 경로를 지정하거나 기존 값을 덮어쓰면 모듈 충돌, 임포트 오류 등 오히려 문제가 생기기 쉽습니다. 프로젝트별 의존성 관리가 필요하다면 가상 환경(virtualenv, venv)을 활용하는 것이 훨씬 안전하고 깔끔한 방법입니다.