파이썬을 처음 공부하려고 마음먹고 공식 홈페이지에서 설치 파일을 다운로드받아 설치를 마친 뒤, 명령 프롬프트(CMD)를 켜서 파이썬을 실행해 본 적이 있는가? 아마 많은 초보자들이 여기서 첫 번째 벽에 부딪히게 된다.
'python'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 배치 파일이 아닙니다.
이 문구를 마주하면 순간 당황스럽기 마련이다. 내가 분명히 설치를 끝냈는데 왜 컴퓨터는 파이썬을 찾지 못하는 걸까? 원인은 간단하다. 윈도우 운영체제에게 파이썬이 어디에 설치되어 있는지 그 위치(경로)를 알려주지 않았기 때문이다. 이 문제를 해결하는 과정은 생각보다 간단하지만, 초보자들에게는 꽤나 불친절하게 느껴질 수 있는 영역이다.
[소제목] 환경 변수란 무엇이며 왜 설정해야 하는가
운영체제인 윈도우는 사용자가 명령 프롬프트에 어떤 단어를 입력하면, 현재 폴더나 시스템이 미리 지정해 둔 특정한 경로 안에서 그 이름을 가진 프로그램을 찾는다. 만약 그 경로 안에 해당 프로그램이 없다면 방금 본 것과 같은 에러 메시지를 띄우게 된다.
파이썬 설치 파일(exe)을 실행할 때 초기 화면 하단에 보면 작은 체크박스 하나가 숨어 있다. 바로 'Add python.exe to PATH'라는 옵션이다.
이 체크박스를 누락한 경우, 파이썬 파일들은 컴퓨터의 깊숙한 폴더에 조용히 설치되지만 윈도우는 그 위치를 알지 못한다.
따라서 명령창에 'python'이라고 쳐도 윈도우는 어디서 실행해야 할지 몰라 헤매게 되는 것이다.
[소제목] 수동으로 환경 변수(PATH) 추가하는 단계별 방법
만약 설치할 때 체크박스를 놓쳤다면, 프로그램을 통째로 지우고 다시 설치할 필요는 없다. 수동으로 시스템 환경 변수에 파이썬 경로를 등록해주면 그만이다. 직접 겪어본 바에 따르면 이 작업은 단 1분이면 끝난다.
윈도우 시작 버튼 옆 검색창에 '환경 변수'를 입력하고, [시스템 환경 변수 편집]을 실행한다.
나타나는 창 하단의 [환경 변수] 버튼을 클릭한다.
상단의 '사용자 변수' 목록이나 하단의 '시스템 변수' 목록에서 'Path'라는 이름의 항목을 찾아 더블클릭한다.
우측의 [새로 만들기] 버튼을 누르고, 파이썬이 설치된 경로를 입력한다. (기본 설치 경로 예시: C:\Users[사용자이름]\AppData\Local\Programs\Python\Python311)
파이썬이 설치된 경로와 그 하위 폴더인 'Scripts' 폴더 경로까지 총 2개를 각각 등록해 주는 것이 안전하다.
모든 창의 [확인]을 눌러 저장한다.
여기서 주의할 점은 폴더 경로를 오타 없이 정확히 입력해야 한다는 것이다. 특히 사용자 이름에 공백이나 특수문자가 포함되어 있다면 경로가 정확한지 파일 탐색기를 통해 직접 확인하고 복사해 넣는 것을 추천한다.
[소제목] 설정 완료 후 정상 작동 여부 확인하기
환경 변수를 수동으로 등록했다면, 기존에 켜져 있던 명령 프롬프트(CMD)나 터미널 창은 반드시 닫았다가 새로 열어야 한다. 이미 열려 있던 창은 이전의 환경 변수 상태를 기억하고 있기 때문이다.
새로운 명령 프롬프트를 켜고 다음 명령어를 입력해 보자.
python --version
정상적으로 버전 정보(예: Python 3.11.x)가 출력된다면 환경 변수 설정이 성공적으로 끝난 것이다. 추가로 'pip --version'도 입력해서 패키지 관리 도구까지 잘 연결되었는지 확인해 두면 이후 공부 과정이 훨씬 매끄러워진다.
[소제목] 초보자가 자주 하는 실수와 주의사항
설정 과정에서 가장 흔하게 저지르는 실수는 파이썬 설치 폴더 자체가 아니라 그 내부의 특정 파이썬 파일(.exe)까지 경로에 포함해 버리는 경우다. 경로에는 반드시 폴더 주소까지만 들어가야 한다.
또한, 관리자 권한이 없는 계정으로 시스템 변수를 수정하려고 하면 권한 거부 오류가 발생할 수 있다. 이럴 때는 사용자 변수 영역을 활용하거나 컴퓨터의 관리자 계정으로 로그인한 상태에서 시도해야 원활한 수정이 가능하다. 처음 개발 환경을 구축할 때는 작은 오타나 사소한 체크박스 하나가 큰 시간 낭비로 이어질 수 있으므로, 단계를 차분히 밟아나가는 태도가 중요하다.
핵심 요약:
파이썬 실행 에러는 대부분 윈도우가 파이썬의 설치 위치를 인식하지 못해 발생한다.
설치 초기 화면의 'Add python.exe to PATH' 체크박스를 누락했다면 수동으로 환경 변수(Path)에 경로를 추가해야 한다.
설정을 마친 후에는 반드시 터미널 창을 재시작하고 'python --version'으로 정상 작동을 검증해야 한다.
0 댓글