리눅스에서 Python 경로(PYTHONPATH) 설정하는 방법

리눅스에서 PYTHONPATH 설정하기

리눅스 환경에서 Python이 모듈과 패키지를 불러올 때 다른 디렉터리도 함께 검색하도록 만들고 싶다면, PYTHONPATH 환경 변수를 내보내기(export)하면 됩니다.

기본 설정 방법

터미널에서 아래와 같은 명령어를 입력하세요.

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

이 명령은 홈 디렉터리 아래의 foo 폴더를 PYTHONPATH에 추가합니다. 여기서 중요한 점은 기존의 PYTHONPATH 값을 덮어쓰는 것이 아니라, 콜론(:)을 이용해 기존 값을 유지하면서 새 경로를 뒤에 추가(append)한다는 것입니다.

주의할 점

대부분의 경우 PYTHONPATH를 임의로 수정하는 것은 권장되지 않습니다. 환경 변수를 잘못 건드리면 모듈 충돌이나 예상치 못한 import 오류가 발생할 수 있으며, 문제가 생겼을 때 원인을 찾기가 오히려 더 어려워질 수 있습니다.

가능하면 가상환경(virtualenv, venv)을 사용하거나 패키지를 올바른 위치에 설치하는 방식으로 의존성을 관리하는 것이 더 안전하고 깔끔한 해결책입니다. PYTHONPATH 수정은 정말 필요한 상황에서만 신중하게 사용하는 것이 좋습니다.