Mac에서 PYTHONPATH란 무엇인가?
PYTHONPATH는 Python 인터프리터가 모듈과 패키지를 import할 때 추가로 탐색할 디렉터리를 지정하는 환경 변수입니다. 기본적으로 Python은 설치된 표준 라이브러리와 현재 작업 디렉터리에서 모듈을 찾지만, 프로젝트 폴더나 커스텀 라이브러리 위치를 알려주고 싶을 때 PYTHONPATH를 활용하면 됩니다.
임시로 PYTHONPATH 설정하기
macOS 터미널에서 export 명령어를 사용하면 현재 세션에 한해 PYTHONPATH를 설정할 수 있습니다:
$ export PYTHONPATH=${PYTHONPATH}:${HOME}/foo위 명령은 홈 디렉터리 아래의 foo 폴더를 PYTHONPATH에 추가합니다. 여기서 중요한 점은 기존 PYTHONPATH 값을 덮어쓰는 것이 아니라 콜론(:)으로 구분하여 뒤에 붙이는(appending) 방식이라는 것입니다. 이렇게 해야 이전에 설정해둔 다른 경로들이 사라지지 않습니다.
설정 확인하기
제대로 적용되었는지 확인하려면 아래 명령어를 입력하세요:
$ echo $PYTHONPATH
또는 Python 내부에서 직접 확인할 수도 있습니다:
$ python -c "import sys; print(sys.path)"
설정을 영구적으로 유지하는 방법
export로 설정한 값은 터미널 세션이 종료되면 사라집니다. 매번 입력하지 않으려면 셸 설정 파일에 추가하세요:
- zsh 사용 시 (macOS Catalina 이상 기본):
~/.zshrc - bash 사용 시:
~/.bash_profile
$ echo 'export PYTHONPATH=${PYTHONPATH}:${HOME}/foo' >> ~/.zshrc
$ source ~/.zshrc주의사항: PYTHONPATH 남용은 피하세요
대부분의 경우 PYTHONPATH를 임의로 수정하는 것은 권장되지 않습니다. 경로 충돌이나 의도치 않은 모듈 로딩 문제를 일으켜 오히려 골치 아픈 상황을 초래할 수 있습니다.
특정 패키지를 관리하고 싶다면 가상 환경(virtualenv, venv)을 사용하거나, 개발 중인 패키지라면 pip install -e . 방식으로 편집 가능한 모드로 설치하는 것이 훨씬 안전하고 깔끔한 해결책입니다.