Windows에서 Python 환경 변수 PYTHONPATH 설정하는 방법

Windows에서 PYTHONPATH 환경 변수 설정하기

Windows에서 Python이 모듈과 패키지를 임포트(import)할 때 기본 경로 외에 다른 디렉터리도 함께 검색하도록 만들고 싶다면 PYTHONPATH 환경 변수를 설정하면 됩니다. 먼저 아래 경로로 이동하세요.

내 컴퓨터(내 PC) > 속성 > 고급 시스템 설정 > 환경 변수

Windows 10 또는 11을 사용 중이라면 작업 표시줄의 검색창에 "환경 변수"라고 입력해 바로 해당 설정 창을 열 수도 있습니다.

PYTHONPATH 값 수정하기

환경 변수 창이 열리면 시스템 변수 목록에서 PythonPath 항목을 찾아 선택한 뒤 [편집] 버튼을 클릭합니다. 그리고 기존 PYTHONPATH 값 맨 끝에 세미콜론(;)을 하나 붙인 후, 추가하고자 하는 디렉터리 경로를 이어서 입력합니다.

C:\Python27;C:\foo

위 예시는 foo 디렉터리를 PYTHONPATH에 추가하는 경우입니다. 이때 기존 값을 통째로 덮어쓰는 것이 아니라, 원래 값 뒤에 새 경로를 덧붙이는(appending) 방식이라는 점에 유의하세요. 기존 값을 삭제해버리면 Python이 필요한 모듈을 찾지 못해 오류가 발생할 수 있습니다.

설정 시 주의사항

대부분의 경우 PYTHONPATH를 임의로 수정하지 않는 것이 좋습니다. 잘못된 경로를 지정하거나 필수 값을 실수로 지워버리면 모듈 임포트 오류 등 예상치 못한 문제가 생기기 쉽습니다. 특별한 이유가 없다면 가상 환경(virtualenv)이나 패키지 관리 도구(pip)를 활용해 의존성을 관리하는 편이 더 안전합니다.

또한 환경 변수를 변경한 후에는 이미 실행 중인 명령 프롬프트, 터미널, IDE를 재시작해야 변경 사항이 정상적으로 반영됩니다. 임시로만 테스트해 보고 싶다면 명령 프롬프트에서 set PYTHONPATH=C:\foo처럼 입력해 세션 단위로 설정할 수도 있습니다.