'pip'은(는) 내부 또는 외부 명령으로 인식되지 않음 오류 해결 방법

명령 프롬프트(Command Prompt)에서 Python 패키지를 설치하려는 일부 사용자에게 'pip'은(는) 내부 또는 외부 명령으로 인식되지 않습니다라는 오류 메시지가 나타나는 문제가 보고되고 있습니다. 대부분의 사용자는 Python 배포판을 설치하고 PATH 환경 변수에 Python이 추가되어 있는지 확인한 후에도 이 문제가 발생한다고 말합니다. 이 문제는 특정 운영체제에 국한된 것이 아니며 Windows 7, Windows 8, Windows 10에서 모두 보고된 사례가 있습니다.

PIP란 무엇인가?

PiP는 'Pip Installs Packages'의 재귀 약자입니다. 쉽게 말해 Python으로 작성된 소프트웨어 패키지를 설치하고 관리하기 위한 패키지 관리 시스템입니다. 대부분의 사용자는 Python Package Index(PyPI)에 등록된 패키지를 설치하고 관리할 때 PiP를 활용합니다.

참고로 최신 Python 버전(Python 2.7.9 이상 및 Python 3.4)에는 Pip이 기본적으로 포함되어 있습니다.

'pip'은(는) 내부 또는 외부 명령으로 인식되지 않음 오류의 원인

다양한 사용자 사례를 조사하고 실제 컴퓨터에서 문제를 재현해 본 결과, 이 오류 메시지를 유발하는 것으로 알려진 시나리오는 다음과 같습니다.

• PIP 설치 경로가 시스템 변수에 추가되지 않음 – CMD 창에서 Python 명령을 실행하려면 PiP 설치 경로를 시스템 변수의 PATH에 추가해야 합니다. Python 설치 실행 파일로 설치했다면 자동으로 추가되어야 하지만, 그렇지 않은 경우도 있습니다.
• PATH에 잘못된 형태로 추가됨 – PATH를 수동으로 추가할 때는 실수하기 쉽습니다. 불필요한 공백이 있거나 새 경로 앞에 세미콜론(;)이 누락되면 이 오류가 발생할 수 있습니다.

CMD에서 Python 명령 사용을 막고 있는 이 오류를 해결하려면 아래 방법들을 순서대로 따라 해 보세요. 아래의 모든 해결책은 실제 사용자들에 의해 효과가 확인된 방법입니다.

최상의 결과를 얻으려면 자신의 상황에 맞는 해결책을 찾을 때까지 아래 방법을 순서대로 진행하는 것이 좋습니다.

방법 1: PIP가 PATH 변수에 추가되어 있는지 확인

먼저 현재 상태부터 파악해 보겠습니다. PIP 설치 경로가 PATH 변수에 추가되어 있는지 확실하지 않다면 CMD 명령 하나로 간단히 확인할 수 있습니다.

이를 미리 알아두면 올바른 방향으로 문제를 해결할 수 있고, 불필요한 단계를 시도하는 시간을 절약할 수 있습니다.

참고: 이미 PIP 설치 경로가 PATH 변수에 추가되어 있는지 안다면 다음 방법으로 바로 넘어가세요.

PIP 설치 경로가 PATH 변수에 포함되어 있는지 확인하는 방법은 다음과 같습니다.

1. Windows 키 + R을 눌러 실행 대화 상자를 엽니다. 그런 다음 'cmd'를 입력하고 Enter 키를 눌러 명령 프롬프트를 실행합니다.
2. 명령 프롬프트 창에 echo %PATH%를 입력하고 Enter 키를 누르면 PATH 변수에 추가된 모든 위치 목록이 표시됩니다.
3. C:\Python37\Scripts와 비슷한 경로(Python 버전에 따라 다름)를 발견했다면 설치 경로가 이미 PATH 변수에 추가되어 있는 것입니다. 이 경우 아래 방법들을 건너뛰고 PiP 설치 경로 관련 문제를 해결하는 방법 4로 바로 이동하세요.

위 테스트에서 PiP 설치 경로를 찾지 못했다면, 아래 방법 2와 방법 3을 통해 PIP를 PATH 환경 변수에 추가하세요.

방법 2: Windows GUI를 통해 PIP를 PATH 환경 변수에 추가

방법 1에서 PIP 설치 경로가 환경 변수로 설정되어 있지 않다는 것이 확인되었고, 이미 Python 배포판을 설치한 상태라면 수동으로 추가해야 합니다.

아래 절차를 완료하면 명령 프롬프트 창에서 PiP 명령을 입력할 수 있게 됩니다. Windows GUI를 사용하여 PiP 설치 경로를 Path 환경 변수에 추가하는 방법은 다음과 같습니다.

1. Windows 키 + R을 눌러 실행 대화 상자를 연 후 'sysdm.cpl'을 입력하고 Enter 키를 눌러 시스템 속성 화면을 엽니다.
2. 시스템 속성 화면에서 고급 탭으로 이동한 후 환경 변수를 클릭합니다.
3. 환경 변수 화면에서 시스템 변수 목록의 Path를 클릭하여 선택한 후 편집... 버튼을 클릭합니다.
4. 환경 변수 편집 화면에서 새로 만들기를 클릭하고 PiP 설치 경로를 추가합니다. Python 3.4의 기본 위치는 C:\Python34\Scripts입니다.
   
5. 경로를 추가한 후 새 CMD 창을 열고 PiP로 설치 가능한 Python 패키지를 설치해 봅니다. 더 이상 'pip'은(는) 내부 또는 외부 명령으로 인식되지 않습니다 오류가 나타나지 않아야 합니다.

환경 변수에 PiP 위치를 더 빠르게 추가하고 싶다면 방법 3을 참고하세요.

방법 3: CMD를 통해 PIP를 PATH 환경 변수에 추가

PIP 경로 환경 변수를 설정하는 더 빠른 방법은 CMD 창에서 직접 설정하는 것입니다. 시간을 절약할 수 있지만, 터미널 사용에 익숙하지 않다면 다소 어렵게 느껴질 수 있습니다.

명령 프롬프트 창에서 직접 PiP 경로 환경 변수를 설정하는 방법은 다음과 같습니다.

1. Windows 키 + R을 눌러 실행 대화 상자를 연 후 'cmd'를 입력하고 Enter 키를 눌러 명령 프롬프트 창을 엽니다.
2. 명령 프롬프트 창에서 다음 명령을 실행하여 PIP 설치 경로를 환경 변수에 설정합니다.

   setx PATH “%PATH%;C:\Python37\Scripts”

   참고: 이 명령에서는 Python 3.7의 기본 설치 위치를 사용했습니다. 다른 Python 버전을 사용 중이거나 사용자 지정 위치에 설치했다면 ';' 뒤의 경로를 실제 환경에 맞게 변경하세요.

3. 같은 CMD 창에서 PIP를 사용하는 Python 패키지를 설치하여 이 방법이 성공했는지 확인합니다. 여전히 오류 메시지가 나타난다면 다음 방법으로 넘어가세요.

방법 4: PiP 변수를 추가하지 않고 Python 패키지 설치하기

PiP를 PATH 환경 변수에 추가하지 않고 CMD에서 Python 패키지를 설치하는 방법도 있습니다. 위의 방법들로 환경 PATH 변수를 구성했는데도 여전히 오류 메시지가 나타나는 경우에도 이 방법이 유용합니다.

PIP 변수를 추가하지 않고 CMD에서 Python 패키지를 설치하는 몇 가지 방법을 소개합니다.

간단한 방법:

1. Windows 키 + R을 눌러 실행 대화 상자를 연 후 'cmd'를 입력하고 Enter 키를 눌러 명령 프롬프트 창을 엽니다.
2. 다음 명령을 입력하되, 자리 표시자 부분을 본인이 설치하려는 패키지 이름으로 변경하세요.

   python -m pip install [packagename]

   참고: [packagename] 부분을 설치하려는 패키지 이름으로 변경합니다.

복잡한 방법:

1. Windows 키 + R을 눌러 실행 대화 상자를 연 후 'cmd'를 입력하고 Enter 키를 눌러 명령 프롬프트 창을 엽니다.
2. CMD 창에서 다음 명령을 사용하여 Python .whl 파일이 있는 디렉터리로 이동합니다.

   cd C:\python installs

   참고: 이 예시에서는 Python 설치 패키지가 'python installs'라는 폴더에 있습니다. 실제 wheel 파일이 있는 디렉터리에 맞게 명령을 조정하세요.

3. 그런 다음 다음 명령을 실행하여 PiP로 Python 패키지를 설치합니다.

   c:\python37\scripts\pip.exe install [package].whl

   참고: 구버전을 사용 중이거나 사용자 지정 위치에 설치한 경우 Python 설치 위치를 변경해야 합니다. 또한 [package] 자리 표시자도 본인의 패키지 이름으로 변경하세요.

위 두 가지 방법으로도 CMD 창에서 Python 패키지를 설치할 수 없다면, 마지막 방법을 따라 PiP가 제대로 설치되어 있는지 확인해 보세요.

방법 5: Python 설치에 PiP가 포함되어 있는지 확인

Python 환경 전체를 다시 설치하기 전에, 먼저 Python 설치 과정에서 PiP가 누락되지 않았는지 확인해 보겠습니다. 일부 Python 설치 프로그램은 기본 설치에서 PiP를 제외하기도 합니다.

다행히 Python 설치를 수정하여 PIP를 추가로 설치하도록 변경하면 이 문제를 해결할 수 있습니다. 방법은 다음과 같습니다.

1. Windows 키 + R을 눌러 실행 대화 상자를 연 후 'appwiz.cpl'을 입력하고 Enter 키를 눌러 프로그램 및 기능을 엽니다.
   
2. 프로그램 및 기능에서 Python 설치 항목을 마우스 오른쪽 버튼으로 클릭하고 변경을 선택합니다.
3. 설치 수정(Modify Setup) 화면에서 수정(Modify)을 클릭합니다.
   
4. 옵션 기능(Optional Features) 화면에서 pip에 해당하는 체크박스를 선택하고 다음을 클릭합니다.
5. 설치 버튼을 눌러 Python 설치에 변경 사항을 적용합니다.
6. Python 설치 수정이 완료되면 CMD 창을 열고 PiP로 Python 패키지를 설치할 때 'pip'은(는) 내부 또는 외부 명령으로 인식되지 않습니다 오류 없이 정상 작동하는지 확인합니다.

방법 6: 실행 파일 설치 프로그램으로 Python 재설치

여기까지 진행했는데도 문제가 해결되지 않았다면, Python과 해당 구성 요소를 함께 재설치하는 것이 'pip'은(는) 내부 또는 외부 명령으로 인식되지 않습니다 오류를 해결하는 가장 확실한 방법일 수 있습니다.

가장 쉬운 방법은 Python 실행 파일 설치 프로그램을 사용하는 것입니다. 올바르게 구성하면 PiP가 자동으로 설치됩니다. 방법은 다음과 같습니다.

1. Windows 키 + R을 눌러 실행 대화 상자를 연 후 'appwiz.cpl'을 입력하고 Enter 키를 눌러 프로그램 및 기능을 엽니다.
2. 프로그램 및 기능에서 프로그램 목록을 스크롤하여 Python 설치 항목을 찾습니다. 찾았으면 마우스 오른쪽 버튼으로 클릭하고 제거를 선택한 후 화면의 안내에 따라 시스템에서 제거합니다. Python 배포판이 삭제되면 컴퓨터를 재시작합니다.
3. 재시작 후 Python 공식 웹사이트에 접속하여 OS 아키텍처에 맞는 최신 Python 실행 파일 설치 프로그램을 다운로드합니다.
4. 설치 파일을 실행하고 Add Python to PATH 체크박스가 선택되어 있는지 먼저 확인합니다. 이 옵션을 선택하면 명령 프롬프트에서 Python 명령을 실행할 수 있습니다. 그런 다음 사용자 지정 설치(Customize installation)를 클릭합니다.
5. 옵션 기능(Optional Features) 창에서 pip에 해당하는 체크박스가 선택되어 있는지 확인한 후 다음을 클릭합니다.
6. 기본 설치 위치와 고급 옵션(Advanced Options)을 그대로 두고 설치(Install)를 클릭하여 설치를 시작합니다.
7. 설치가 완료되면 자동으로 재시작하라는 메시지가 표시되지 않는 경우 컴퓨터를 수동으로 재시작합니다.
8. 재시작 후 CMD 창을 통해 Python 패키지를 설치하여 문제가 해결되었는지 확인합니다.
9. 여전히 'pip'은(는) 내부 또는 외부 명령으로 인식되지 않습니다 오류가 나타난다면 CMD 창에 다음 명령을 입력합니다.

   python -m ensurepip --default-pip

   참고: 일부 Python 배포판(특히 3.6)에서는 PiP가 기본적으로 설치되지 않을 수 있습니다. 공식 문서에 포함된 해결 방법 중 하나가 바로 이 명령입니다.