리눅스에 파이썬 pip를 설치하는 방법(Command 'pip' not found, but can be installed with)

pip 버전 확인 방법

Linux에 pip를 설치하는 방법

$ pip install <module>
Command 'pip' not found, but can be installed with:
sudo apt install python3-pip

리눅스 환경에서 pip를 이용해 파이썬 모듈을 설치하려다가 위와 같은 에러를 만나는 경우가 있다.
이런 경우 pip를 설채해줘야하는데, 설치방법은 간단하다. 터미널에 다음 명령어를 입력하면 끝이다.

sudo apt install python3-pip -y

주의사항

어찌보면 당연한 말이지만, 설치된 pip의 버전은 사용하려는 파이썬의 버전과 일치해야 한다.
만약 파이썬 3.11을 사용하는데 pip는 파이썬 3.10 버전을 지원한다면, pip를 통해 어떤 모듈을 설치한다고 하더라도 파이썬 3.11에서는 모듈을 사용할 수 없다.

pip -V 명령을 통해 호출되는 정보에서 해당 pip가 지원하는 파이썬 버전을 확인할 수 있다.

# pip 버전과 파이썬 버전이 상이한 경우
$ pip -V
python3/dist-packages/pip (python 3.10)
$ python -V
Python 3.11.3

특정 버전의 파이썬을 지원하는 pip 호출방법

pip 명령을 사용할 때 "pip{파이썬 버전}"과 같이 버전을 붙여서 입력하면 된다.
다음은 pip 버전을 확인하는 예시다.

# 파이썬 3.11용 pip(해당 버전의 pip가 없는 경우)
$ pip3.11 -V
Command 'pip3.11' not found, did you mean:
  command 'pip3.10' from deb python3-pip (22.0.2+dfsg-1ubuntu0.3)
Try: sudo apt install <deb name>

# 파이썬 3.10용 pip(해당 버전의 pip가 있는 경우)
$ pip3.10 -V
pip 22.0.2 from /usr/lib/python3/dist-packages/pip (python 3.10)

버전을 특정해서 pip 설치하기

앞서 apt install을 통해 pip를 설치했기 때문에, python -m pip install 명령을 사용할 수 있다.
대체로 이 명령으로 문제 해결이 가능할 것이지만.. 다음과 같이 경고 문구가 노출되며 설치에 실패하는 경우가 있을 수 있다.

$ python3.11 -m pip install --upgrade pip
Defaulting to user installation because normal site-packages is not writeable
Requirement already satisfied: pip in /usr/lib/python3/dist-packages (22.0.2)
Collecting pip
  Downloading pip-23.1.2-py3-none-any.whl (2.1 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 2.1/2.1 MB 17.2 MB/s eta 0:00:00
Installing collected packages: pip
  WARNING: The scripts pip, pip3, pip3.10 and pip3.11 are installed in '/home/ubuntu/.loca
l/bin' which is not on PATH.
  Consider adding this directory to PATH or, if you prefer to suppress this warning, use -
-no-warn-script-location.
Successfully installed pip-23.1.2
$ pip3.11 -V
Command 'pip3.11' not found, did you mean:
  command 'pip3.10' from deb python3-pip (22.0.2+dfsg-1ubuntu0.3)
Try: sudo apt install <deb name>

설치에 실패하는 경우

pip 설치에 실패하는 문제가 발생한 경우 이 글을 참고하자.

임시방편

"python{파이썬 버전} -m pip install <module>" 명령으로 버전을 특정하여 모듈을 설치할 수 있다.
명령어가 길어지는 것을 신경쓰지 않는다면 이 방법을 사용하면 된다.

$ python3.10 -m pip install requests
$ python
Python 3.10.6 (main, May 29 2023, 11:10:38) [GCC 11.3.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> import requests
>>>