PYTHONPATH 환경 변수의 정의
PYTHONPATH는 Python이 모듈과 패키지를 검색할 때 참조하는 추가 디렉터리를 지정할 수 있는 환경 변수입니다. 이 변수를 설정하면 Python은 기본 검색 경로 외에도 해당 디렉터리에 있는 모듈들을 불러올 수 있습니다.
대부분의 경우 설정할 필요가 없습니다
일반적인 설치 환경에서는 PYTHONPATH를 설정하지 않는 것이 좋습니다. Python이 정상적으로 실행되는 데 이 변수가 필수적이지 않기 때문입니다. Python은 자체적으로 표준 라이브러리(standard library)의 위치를 인식하고 있으며, 별도의 설정 없이도 기본 모듈들을 문제없이 찾아 사용합니다.
PYTHONPATH를 설정하는 유일한 이유
PYTHONPATH를 굳이 설정해야 하는 경우는 전역 기본 위치(즉, site-packages 디렉터리)에 설치하고 싶지 않은 사용자 지정 Python 라이브러리를 별도의 디렉터리에서 관리하고 싶을 때뿐입니다. 예를 들어 다음과 같은 상황에서 유용합니다.
- 프로젝트별로 개발 중인 라이브러리를 시스템에 설치하지 않고 테스트해야 할 때
- 여러 버전의 라이브러리를 충돌 없이 분리하여 관리해야 할 때
- 회사 내부용 등 배포되지 않는 비공개 모듈을 특정 경로에 두고 사용할 때
참고 자료
Python 환경 변수에 대해 더 깊이 이해하고 싶다면 아래 공식 문서를 확인해 보세요.
https://docs.python.org/using/cmdline.html#environment-variables