파이썬(Python) 환경변수(PATH) 설정 오류 3초 만에 잡기

파이썬을 야심 차게 설치하고 코딩을 시작하려는데, 'python은 내부 또는 외부 명령...'이라는 차가운 에러 메시지만 마주하셨나요? 분명히 설치를 마쳤는데 명령어가 먹히지 않아 답답하셨을 탭입니다. 이 문제는 윈도우 시스템이 파이썬이 어디에 설치되어 있는지 길을 찾지 못해 발생하는 현상으로, 단 3초 만에 환경변수(PATH)만 잡아주면 완벽하게 해결할 수 있습니다. 지금 바로 가장 쉽고 빠른 해결 방법을 확인해 보세요!

1. 파이썬 환경변수(PATH) 설정 오류, 왜 발생하는 걸까요?

파이썬 설치 파일(.exe)을 실행할 때 하단에 있는 체크박스 중 'Add python.exe to PATH'(파이썬을 PATH에 추가)를 체크하지 않고 넘어갔거나, 설치 경로가 시스템 변수에 정상적으로 등록되지 않았을 때 발생합니다.

  • 운영체제의 한계: 윈도우는 사용자가 입력한 명령어(python)가 컴퓨터 어디에 숨겨져 있는지 모릅니다.
  • PATH의 역할: 운영체제가 파이썬 실행 파일(python.exe)을 다이렉트로 찾아갈 수 있도록 '이정표'를 세워주는 작업이 바로 환경변수 설정입니다.

2. 단 3초 만에 끝내는 윈도우 파이썬 환경변수 설정 방법

복잡한 명령어 없이 윈도우 설정 창에서 마우스 클릭 몇 번만으로 해결할 수 있습니다. 아래 순서대로 차근차근 따라 해 보세요.

단계 1: 파이썬 설치 경로(폴더 주소) 복사하기

기본적으로 파이썬은 사용자 숨김 폴더에 설치됩니다. 내 PC에서 아래 경로를 찾아주세요. (사용자 이름 부분은 본인의 PC 계정명으로 변경됩니다.)

C:\Users\본인계정명\AppData\Local\Programs\Python\Python3X

  • 이 폴더 안에서 python.exe 파일이 정상적으로 존재하는지 확인한 뒤, 상단 주소창을 클릭하여 경로를 복사합니다.
  • 추가로 ...\Python3X\Scripts\ 경로도 함께 복사해 둡니다 (pip 패키지 관리용).

단계 2: 시스템 '환경 변수' 메뉴 진입하기

  1. 윈도우 시작 버튼 옆 검색창에 '환경 변수'를 검색합니다.
  2. '시스템 환경 변수 편집' 메뉴를 클릭합니다.
  3. 창이 뜨면 우측 하단의 [환경 변수(N)...] 버튼을 클릭합니다.

단계 3: PATH 변수에 경로 추가하기

  1. 상단 또는 하단 박스에서 'Path'라는 이름의 변수를 찾아서 더블클릭합니다.
  2. 우측의 [새로 만들기] 버튼을 누르고, 아까 복사해 둔 파이썬 설치 경로와 Scripts 경로를 각각 입력합니다.
  3. [확인]을 눌러 모든 창을 닫아줍니다. (열려 있던 CMD 창은 반드시 닫았다가 새로 켜야 적용됩니다.)

3. 설정 완료 후 정상 작동 확인 방법

환경변수 등록이 끝났다면, 파이썬이 제대로 인식되는지 확인해 볼 차례입니다.

  • 윈도우 검색창에 cmd를 입력해 명령 프롬프트를 켭니다.
  • python --version 명령어를 입력하고 엔터를 칩니다.
  • 화면에 Python 3.x.x 형태로 버전 정보가 출력되면 설정이 완벽하게 끝난 것입니다!

결론 및 요약

파이썬 환경변수(PATH) 설정 오류는 초보 개발자라면 누구나 한 번쯤 겪는 매우 흔한 증상입니다. 설치 시 체크박스 하나만 신경 쓰면 앞으로 이런 번거로움을 겪지 않을 수 있습니다. 오늘 알려드린 3단계 방법을 통해 막힘없이 코딩 환경을 구축하시기 바라며, 더 많은 IT 정보와 개발 팁이 필요하다면 블로그의 다른 글들도 참고해 보세요!