💡pip install이 안될 때: pip vs pip3

최근 수정 날짜: 25.01.20

---

pip install를 가지고 설치를 시도하는데 자꾸 설치 오류가 발생했었고,,,삽질을 좀 했다. 구글링을 하던 중 pip3 install을 알게되어 다음 명령어로 설치를 할 수 있었다.

이번 기회에 pip와 pip3의 차이점, 왜 이런 일이 발생했는지, 그리고 어떻게 대처해야 하는지 정리해 보았다.

🐍 pip와 pip3의 차이

• pip: 일반적으로 Python 2.x에 연동된 패키지 관리 도구이다.
• pip3: Python 3.x에서 사용되는 패키지 관리 도구이다.

Python2와 3는 서로 호환되지 않는 부분이 많아 별도의 패키지 관리 도구를 사용하는 경우가 많이 발생했어서 현재는 Python 2의 공식 지원이 종료되었지만, 여전히 일부 환경에서 pip는 Python 2.x 버전과 연동되어 있는 경우가 있다고 하더라,,,

⚡️ 왜 이런 일이 발생했을까?

1. 설치된 Python 버전이 여러 개 존재하는 경우

• 시스템에 Python 2.x와 3.x가 모두 설치된 경우, 기본적으로 pip는 Python 2와 연동되고, Python 3용 패키지 관리 도구는 pip3로 제공된다.

2. pip가 기본적으로 Python 3와 연결되지 않은 환경

• 일부 시스템에서 pip는 여전히 Python 2.x와 연결되어 있는 경우가 있습니다. 이 경우 Python 3.x에 필요한 패키지를 설치하려면 pip3를 명시적으로 사용해야 합니다.

🔧 어떻게 대처해야 할까?

1. Python 버전 확인

• 먼저 python --version과 python3 --version으로 설치된 Python 버전을 확인한다.
• 기본적으로 어떤 Python 버전이 실행되는지도 확인하려면 which python과 which python3 명령어를 사용한다.

2. pip와 pip3 확인

• pip --version과 pip3 --version으로 각 명령어가 어떤 Python 버전과 연결되어 있는지 확인한다.

3. 패키지 설치 시 명시적으로 Python 버전을 지정

• Python 3용 패키지 설치가 필요하다면 항상 pip3 install을 사용한다.
• 만약 Python 3.x가 기본 설정으로 되어 있다면, python3 -m pip install을 사용해 확실하게 설치할 수 있다.

4. 가상 환경(virtualenv) 활용

• 다양한 버전의 Python을 사용하는 경우, 가상 환경을 설정하면 혼란을 줄일 수 있다.
• 예: python3 -m venv myenv로 가상 환경을 생성한 뒤, 활성화(source myenv/bin/activate)하고 pip 명령어를 사용하면 기본적으로 Python 3와 연동됩니다.

🚀 결론

• pip와 pip3의 차이를 이해하고, 설치된 Python 버전을 확인한 후 적절한 명령어를 사용하면 문제를 쉽게 해결할 수 있었고, 강의나 문서에 나오는 명령어가 항상 내 환경에 맞는 것은 아니므로, 환경에 따라 명령어를 조정해야 할 때도 있다는 사실을 알게 되었다.
• 이번 경험을 통해 여러분도 설치 관련 이슈를 좀 더 쉽게 대처할 수 있었음 좋겠다.