파이썬 환경 변수 설정 오류 (Python environment variable setting error)
소개
프로그래밍을 처음 배우는 사람들은 파이썬을 많이 사용하는 것으로 알려져 있습니다. 하지만 파이썬을 사용하기 위해서는 어떤 환경에서도 파이썬을 실행할 수 있도록 환경 변수를 설정해주어야 합니다. 이 때, 문제가 생길 경우 어떻게 해결해야 할 지 모르는 사람들도 있습니다. 따라서 이번 포스팅에서는 파이썬 환경 변수 설정 오류와 이에 대한 해결 방법에 대해 다루어보도록 하겠습니다.
오류 메시지
파이썬 환경 변수를 설정할 때, 환경 변수에 파이썬 경로를 추가하는데 오류가 발생할 수 있습니다. 이 때, 주로 발생하는 오류 메시지는 다음과 같습니다.
'python'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는
배치 파일이 아닙니다.
원인
위에서 언급한 오류 메시지의 원인은 파이썬이 시스템 환경 변수에 등록되지 않았기 때문입니다. 즉, 시스템이 파이썬을 인식하지 못하는 것입니다. 이러한 경우, 파이썬을 실행할 때마다 경로를 지정해주어야 하는 불편함이 발생하며, 이는 오류 발생 가능성을 높입니다.
해결 방법
위에서 언급한 오류 메시지를 보면, 파이썬이 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 배치 파일이 아니라는 것을 알 수 있습니다. 따라서 이를 해결하기 위해 다음과 같은 작업을 해주어야 합니다.
- 시스템 환경 변수 설정
시스템 환경 변수에 파이썬 경로를 등록해주어야 합니다. 이를 위해 다음의 작업을 수행합니다.
- 내 컴퓨터에서 마우스 오른쪽 버튼을 클릭하여 속성을 선택합니다.
- 고급 시스템 설정을 선택합니다.
- 환경 변수를 선택합니다.
- 시스템 변수에서 새로 만들기를 선택합니다.
- 변수 이름에는
PYTHONPATH를 입력하고, 변수 값에는C:\Python\과 같이 파이썬이 설치된 경로를 입력해줍니다. -
변경된 환경 변수를 저장합니다.
-
명령 프롬프트(Mockup)에서 파이썬 PATH 확인
위에서 환경 변수를 등록한 후에는 명령 프롬프트에서 PATH를 확인해보는 것이 좋습니다. 이를 위해 다음의 작업을 수행합니다.
- 윈도우 시작 버튼을 누른 후 명령 프롬프트(Mockup)를 실행합니다.
echo %PYTHONPATH%를 입력합니다.- 등록한 경로가 확인되면 정상적으로 설정이 된 것입니다.
마무리
위에서 언급한 오류 메시지는 파이썬 환경 변수 설정에 문제가 있다는 것을 알려주는 메시지입니다. 따라서 해당 문제를 해결하기 위해서는 시스템 환경 변수 설정과 명령 프롬프트에서 PATH 확인 작업이 필요합니다. 이를 통해 파이썬을 보다 원활하게 사용할 수 있습니다.