최근 Python의 인기가 급상승하면서 많은 사용자가 Windows 명령 프롬프트에서 직접 Python 명령을 실행하려고 시도하고 있습니다. 하지만 매번 명령어에 Python의 전체 경로를 지정하지 않으면 "'python'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 배치 파일이 아닙니다."라는 오류 메시지를 마주하게 됩니다.
'python은 내부 또는 외부 명령으로 인식되지 않습니다' 오류의 원인
이 오류는 사용자가 Python 배포판의 전체 경로를 지정하지 않았기 때문에 발생합니다. 현재 상태에서 명령을 성공적으로 실행하려면 명령어 안에 Python이 설치된 전체 경로를 직접 입력해야만 합니다.
매번 전체 경로를 일일이 입력하지 않고 Python 명령을 편리하게 실행하려면 Windows 환경 변수(Path)에 Python을 수동으로 등록해야 합니다. 처음 해보는 분들에게는 다소 복잡하게 느껴질 수 있는 작업입니다.
그래서 이번 가이드에서는 Windows 환경에 Python 경로를 추가하는 과정을 단계별로 자세히 안내해 드립니다.
Windows PATH에 Python 추가하기
이 절차가 성공적으로 진행되려면 먼저 컴퓨터에 Python이 올바르게 설치되어 있어야 합니다.
참고: Python 3.3 이상의 Windows 공식 설치 프로그램에는 python.exe를 시스템 검색 경로에 자동으로 추가해 주는 옵션이 포함되어 있습니다. 이 방식으로 설치하면 아래의 수동 설정 과정을 생략할 수 있습니다. Python 공식 웹사이트에서 최신 웹 설치 관리자를 다운로드한 후, 자신의 CPU 아키텍처(x86 또는 x64)에 맞는 Windows 실행 파일 설치 프로그램을 내려받아 실행하세요. 이때 설치 화면에서 "Add Python to PATH" 옵션을 반드시 체크해야 합니다.
이미 Python이 설치되어 있다면 아래 단계를 따라 Windows 경로에 Python을 추가하세요. 성공적으로 완료하면 명령 프롬프트 창에서 전체 경로를 지정하지 않고도 Python 명령을 바로 실행할 수 있습니다. 이 절차는 Windows 7, Windows 8(8.1), Windows 10 및 Windows 11에서 모두 호환됩니다.
- Windows 키 + Pause 키를 동시에 눌러 시스템 속성(System Properties) 창을 엽니다. 또는 시작 메뉴에서 내 PC(This PC)를 마우스 오른쪽 버튼으로 클릭한 후 속성(Properties)을 선택해도 됩니다.
- 시스템 정보 화면에서 왼쪽 사이드바에 있는 고급 시스템 설정(Advanced system settings) 링크를 클릭합니다.
- 시스템 속성 창에서 고급(Advanced) 탭으로 이동한 뒤, 화면 하단의 환경 변수(Environment Variables) 버튼을 클릭합니다.
- 환경 변수 창이 열리면 시스템 변수(System variables) 섹션에서 Path 항목을 선택하고 편집(Edit) 버튼을 클릭합니다.
- 새로 만들기(New) 버튼을 클릭하여 목록 끝에 Python 설치 경로를 추가합니다. 여러 개의 경로는 세미콜론(;)으로 구분하여 입력할 수 있습니다.
(예: C:\Users\사용자이름\AppData\Local\Programs\Python\Python39) - 확인(OK)을 클릭하여 변경 사항을 저장한 후, 명령 프롬프트에서 Python 명령을 실행해 보세요. 위 단계를 올바르게 수행했다면 전체 경로를 지정하지 않고도 명령을 문제없이 입력할 수 있습니다.
추가 팁: 환경 변수를 변경한 후에는 기존에 열려 있던 명령 프롬프트 창에 새로운 Path가 적용되지 않으므로, 반드시 명령 프롬프트를 새로 열어 확인하세요. 그래도 동일한 오류가 발생한다면 python.exe가 실제로 위치한 폴더 경로를 정확히 입력했는지 다시 한번 점검해 보시기 바랍니다.