파이썬

Windows 환경 변수 PATH 설정 가이드

오래충분 2025. 4. 24. 15:18
반응형

 

 

Windows 환경 변수 PATH 설정 가이드

Windows 시스템에서 환경 변수 PATH를 확인하고 수정하는 방법에 대한 상세 가이드입니다.

환경 변수 PATH란?

환경 변수 PATH는 명령 프롬프트나 PowerShell에서 실행 파일을 찾을 때 참조하는 디렉토리 목록입니다. PATH에 프로그램 디렉토리를 추가하면 해당 프로그램을 어느 위치에서든 실행할 수 있습니다.

PATH 환경 변수 확인 및 편집 방법

방법 1: GUI를 통한 설정

  1. 환경 변수 설정 창 열기
    • 시작 메뉴에서 "환경 변수" 검색 → "시스템 환경 변수 편집" 선택
    • 또는 Windows 키 + R → sysdm.cpl 입력 → Enter → "고급" 탭 → "환경 변수" 버튼
  2. PATH 변수 편집
    • "환경 변수" 창에서 아래쪽 "시스템 변수" 목록에서 "Path" 찾기
    • "Path" 선택 후 "편집" 버튼 클릭
  3. 경로 추가/수정/삭제
    • Windows 10 이상: 각 경로가 별도 행에 표시됨
      • "새로 만들기" 버튼 클릭하여 새 경로 추가
      • 기존 경로 선택 후 "편집" 또는 "삭제" 버튼 클릭하여 수정/삭제
    • Windows 8.1 이하: 경로가 세미콜론(;)으로 구분되어 한 줄에 표시됨
      • 경로 목록 끝에 세미콜론(;) 추가 후 새 경로 입력
  4. 변경사항 적용
    • 모든 창에서 "확인" 버튼 클릭하여 저장
    • 열려있는 명령 프롬프트나 PowerShell 창을 모두 닫고 새로 열어야 변경사항 적용됨

방법 2: 명령 프롬프트를 통한 임시 설정

  1. 현재 세션에만 적용되는 임시 PATH 설정
  2. set PATH=%PATH%;C:\새로운경로
  3. 현재 PATH 확인
  4. echo %PATH%

방법 3: PowerShell을 통한 설정

  1. 현재 PATH 확인
  2. $env:Path
  3. 현재 세션에만 적용되는 임시 PATH 설정
  4. $env:Path += ";C:\새로운경로"
  5. 시스템 PATH 영구 변경 (관리자 권한 필요)
  6. [Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\새로운경로", [EnvironmentVariableTarget]::Machine)

Python 관련 PATH 설정

필요한 Python 경로 확인

  1. Python 설치 위치 확인
  2. python -c "import sys; print(sys.executable)"
  3. 일반적인 Python PATH 경로
    • Python 디렉토리: C:\Python3X\ 또는 C:\Users\사용자이름\AppData\Local\Programs\Python\Python3X\
    • Scripts 디렉토리: C:\Python3X\Scripts\ 또는 C:\Users\사용자이름\AppData\Local\Programs\Python\Python3X\Scripts\
    • Microsoft Store 버전: C:\Users\사용자이름\AppData\Local\Microsoft\WindowsApps\PythonSoftwareFoundation.Python.3X_xxx\

성공적인 설정 확인 방법

PATH 설정이 올바르게 되었는지 확인하려면, 새 명령 프롬프트 창을 열고 다음 명령을 실행하세요:

python --version
pip --version
pyinstaller --version  # PyInstaller가 설치된 경우

위 명령이 오류 없이 버전 정보를 출력한다면, PATH 설정이 성공적으로 완료된 것입니다.

자주 발생하는 문제와 해결 방법

  1. "'python'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 배치 파일이 아닙니다."
    • 원인: Python이 설치되지 않았거나 PATH에 추가되지 않음
    • 해결: Python 설치 확인 및 PATH에 Python 디렉토리 추가
  2. "'pip'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 배치 파일이 아닙니다."
    • 원인: pip가 설치되지 않았거나 PATH에 Scripts 디렉토리가 추가되지 않음
    • 해결: PATH에 Python의 Scripts 디렉토리 추가
  3. 변경사항이 적용되지 않음
    • 원인: 명령 프롬프트 재시작 필요
    • 해결: 기존 명령 프롬프트 창을 닫고 새로 열기
  4. Microsoft Store 버전 Python 관련 이슈
    • 문제: PATH 설정이 정상적으로 되지 않을 수 있음
    • 해결: python -m pip install 패키지명 형식으로 명령 실행
    • 대안: python.org에서 Python 다운로드 후 "Add Python to PATH" 옵션 체크하여 설치
반응형