Windows에서 PYTHONPATH 설정하는 방법 – 파이썬 모듈 검색 경로 추가하기

Windows 환경에서 파이썬이 모듈이나 패키지를 불러올(import) 때 다른 디렉터리까지 함께 검색하도록 만들고 싶다면 PYTHONPATH 환경 변수를 설정하면 됩니다. 아래 순서대로 따라 해 보세요.

1. 환경 변수 창 열기

먼저 다음 경로로 이동합니다.

내 PC > 속성 > 고급 시스템 설정 > 환경 변수

2. PythonPath 변수 수정하기

환경 변수 창에서 시스템 변수(System variables) 목록 안의 PythonPath 항목을 찾아 편집합니다.

기존 PYTHONPATH 값의 맨 끝에 세미콜론(;)을 붙인 뒤, 추가하고 싶은 디렉터리 경로를 이어서 입력합니다.

C:\Python27;C:\foo

3. 주의사항

위 예제에서는 foo 디렉터리를 PYTHONPATH에 새로 추가한 것입니다. 중요한 점은 기존 값을 덮어쓰는(대체하는) 것이 아니라 뒤에 덧붙이는(append) 방식이라는 점입니다. 기존 값을 지워버리면 파이썬이 기본 모듈을 찾지 못해 오류가 발생할 수 있습니다.

또 하나 기억할 점은, 특별한 이유가 없다면 PYTHONPATH를 함부로 수정하지 않는 것이 좋다는 것입니다. 대부분의 경우 이 변수를 건드리는 것 자체가 잘못된 접근일 수 있으며, 오히려 의존성 충돌이나 예기치 않은 오류 등 골치 아픈 문제만 일으킬 가능성이 큽니다. 가상환경(virtualenv, venv) 사용이나 패키지 관리 도구(pip) 활용을 먼저 고려해 보는 것이 더 안전한 방법입니다.