[Python] "command not found: pip" 해결

Python에서 발생한 "command not found: pip" 에러 해결 방법에 대해 설명합니다. 이 글에서는 에러 상황과 원인, 해결 방법을 자세하게 다룹니다.

문제상황

에러가 발생한 코드:

import requests

url = "https://api.example.com/data"
response = requests.get(url)

print(response.json())

위의 코드는 외부 API에서 데이터를 가져오기 위해 requests 모듈을 사용하고 있습니다. 이 코드는 웹에서 JSON 형식의 데이터를 가져와 출력하는 간단한 코드입니다.

에러로그 내용:

command not found: pip

원인분석

이 에러는 일반적으로 pip라는 패키지 관리자가 시스템에 설치되어 있지 않거나, 설치된 경로가 환경 변수에 추가되지 않아 발생하는 문제입니다. pip는 Python에서 라이브러리를 설치하거나 관리할 때 사용하는 패키지 관리자입니다.

에러 발생 원리를 각각 단계별로 설명:

1. 코드 실행 시, 필요한 requests 모듈이 설치되어 있지 않은 경우
2. 사용자가 pip install requests를 실행하여 모듈을 설치하려고 시도함
3. 하지만 pip가 설치되어 있지 않거나, 환경 변수에 추가되지 않아서 "command not found: pip" 에러가 발생함

해결방법-1. pip 설치 및 환경 변수 추가

에러가 수정된 코드+ 수정된 부분에 대한 주석:

# Python 3.x 버전을 사용한다면
$ curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
$ python3 get-pip.py

# Python 2.x 버전을 사용한다면
$ curl https://bootstrap.pypa.io/pip/2.7/get-pip.py -o get-pip.py
$ python2 get-pip.py

해결된 코드의 작동 원리를 각각 단계별로 설명:

1. 위의 명령어를 사용하여 pip를 설치합니다. Python 3.x와 2.x 버전에 따라 다른 명령어를 사용해야 합니다.
2. 설치가 완료된 후, 환경 변수에 pip의 경로를 추가해야 합니다. 이를 위해 시스템에 따라 다음과 같은 작업을 수행합니다.
   • 윈도우: 제어판 → 시스템 → 고급 시스템 설정 → 환경 변수에서 Path 변수에 pip의 경로를 추가합니다.
   • 맥OS/리눅스: ~/.bashrc, ~/.bash_profile 또는 ~/.zshrc 파일에 export PATH=$PATH:/path/to/pip를 추가하고, source ~/.bashrc와 같은 명령어로 변경 사항을 적용합니다. (/path/to/pip는 실제 pip의 경로로 변경해야 합니다.)
3. 환경 변수에 pip의 경로가 추가되었다면, 새로운 터미널 창을 열어 pip install requests를 실행하여 필요한 라이브러리를 설치합니다.
4. 라이브러리가 정상적으로 설치되면, 에러가 발생하지 않고 코드를 실행할 수 있습니다.

해결방법-2. Python 가상 환경 사용

에러가 수정된 코드+ 수정된 부분에 대한 주석:

$ python3 -m venv myvenv
$ source myvenv/bin/activate
(myvenv) $ pip install requests

해결된 코드의 작동 원리를 각각 단계별로 설명:

1. Python 가상 환경(virtual environment)을 생성합니다. 가상 환경은 프로젝트별로 독립된 환경을 제공하여, 라이브러리 간의 충돌을 방지할 수 있습니다.
2. 생성한 가상 환경을 활성화합니다. 가상 환경이 활성화되면, 터미널 프롬프트 앞에 가상 환경 이름이 표시됩니다.
3. 활성화된 가상 환경에서 pip install requests를 실행하여 필요한 라이브러리를 설치합니다.
4. 라이브러리가 정상적으로 설치되면, 에러가 발생하지 않고 코드를 실행할 수 있습니다.

참고링크

1. Python 공식 홈페이지 - pip 설치
2. Python 공식 홈페이지 - 가상 환경 사용