Ubuntu에서 pip 설치 및 가상 환경 활용 완전 가이드 | 초보자를 위한 단계별 안내

1. Ubuntu에서 pip를 설치하는 방법

Ubuntu에서는 Python 패키지 관리 도구로서 pip가 필수입니다. pip를 사용하면 Python 라이브러리와 모듈을 쉽게 관리하고, 개발 효율을 높일 수 있습니다. 이 섹션에서는 Ubuntu에서 pip를 설치하는 절차를 설명합니다.

1.1 Python 3용 pip 설치 방법

Ubuntu에는 기본적으로 Python 3가 설치되어 있지만, pip는 수동으로 추가해야 합니다. 아래 절차대로 설치하십시오.
  1. 패키지 목록 업데이트
   sudo apt update
최신 패키지 목록을 받아 시스템의 패키지 정보를 업데이트합니다.
  1. pip 설치
   sudo apt install python3-pip
이렇게 하면 pip가 설치됩니다.
  1. 설치 확인
   pip3 --version
이 명령으로 pip가 올바르게 설치되었는지 확인할 수 있습니다.

1.2 Python 2용 pip 설치 방법

Python 2는 지원이 종료되었지만, 특정 환경에서 필요할 경우 아래 절차로 설치할 수 있습니다.
  1. Universe 저장소 활성화
   sudo add-apt-repository universe
   sudo apt update
  1. Python 2와 pip 설치
   sudo apt install python2
   curl https://bootstrap.pypa.io/get-pip.py --output get-pip.py
   sudo python2 get-pip.py
侍エンジニア塾

2. pip이란? Python 패키지 관리 도구 개요

pip은 Python 라이브러리와 모듈을 PyPI(Python Package Index)에서 쉽게 설치할 수 있는 도구입니다. 이를 통해 복잡한 의존 관계를 손쉽게 관리할 수 있어 개발 효율이 향상됩니다.

2.1 pip의 기본적인 역할

pip을 사용하면 다음과 같은 작업이 가능합니다.
  • 패키지 설치
   pip install <패키지명>
  • 패키지 제거
   pip uninstall <패키지명>
  • 패키지 업그레이드
   pip install --upgrade <패키지명>

2.2 pip의 장점

  • 의존 관계 해결: pip은 패키지 간의 의존 관계를 자동으로 처리하고, 여러 라이브러리를 적절히 관리합니다.
  • 최신 라이브러리를 손쉽게 획득: PyPI에 등록된 최신 라이브러리를 즉시 설치할 수 있습니다.

3. Ubuntu에서 pip 사용 시 주의사항

Ubuntu 환경에서 pip를 사용할 때, 시스템 패키지 관리(apt)와 충돌할 가능성이 있습니다. 특히 시스템 전체에 영향을 주고 싶지 않은 경우에는 --user 옵션을 사용하여 사용자 수준에 설치하는 것이 권장됩니다.

3.1 --user 옵션을 사용한 설치

pip install --user <패키지명>
이렇게 하면 패키지가 사용자 홈 디렉터리에 설치되어 시스템 전체에 영향을 주지 않습니다.

3.2 pip install 오류 대처법

Ubuntu 23.04 이후에서는 가상 환경 밖에서 pip를 직접 사용하려고 하면 오류가 발생할 수 있습니다. 이 문제는 가상 환경을 만들어 그 안에서 패키지를 설치하거나, pipx를 사용해 애플리케이션을 설치함으로써 해결할 수 있습니다.

4. 가상 환경 설정 및 pip 사용

여러 프로젝트에서 서로 다른 라이브러리를 사용할 경우, 가상 환경을 활용하면 라이브러리 간 충돌을 방지할 수 있습니다. 가상 환경은 프로젝트마다 다른 의존성을 가질 수 있게 하여, 개발 환경을 깔끔하게 유지하기 위한 강력한 도구입니다.

4.1 가상 환경 만들기

먼저, venv 모듈을 설치하여 가상 환경을 만듭니다.
sudo apt install python3-venv
python3 -m venv myenv

4.2 가상 환경 활성화

가상 환경을 활성화하려면, 다음 명령을 실행합니다.
source myenv/bin/activate
활성화하면 터미널 프롬프트에 가상 환경 이름이 표시됩니다.

4.3 가상 환경 내 패키지 관리

가상 환경 내에서 패키지를 설치할 경우, 일반 pip 명령을 사용할 수 있습니다.
pip install <패키지명>

4.4 가상 환경 종료

가상 환경을 종료하려면, 아래 명령을 실행합니다.
deactivate

5. 트러블슈팅: pip와 가상 환경에 관한 문제 해결

가상 환경이나 pip를 사용할 때 문제가 발생할 수 있습니다. 여기에서는 흔히 발생하는 문제와 그 해결책을 소개합니다.

5.1 가상 환경을 활성화할 수 없는 경우

가상 환경이 활성화되지 않을 경우, 먼저 올바른 디렉터리에 있는지 확인합니다. 아래 명령으로 activate 스크립트가 존재하는지 확인할 수 있습니다.
ls /path/to/your/environment/bin

5.2 패키지가 올바르게 설치되지 않는 경우

가상 환경이 활성화되지 않으면, 패키지가 시스템 전체에 설치될 수 있습니다. 가상 환경을 활성화한 후 다시 시도하십시오.

5.3 pip 설치 시 오류 해결

Ubuntu 23.04 이후에 “externally managed environment” 오류가 발생한 경우, 가상 환경을 사용하거나 pipx를 이용해 애플리케이션을 설치하면 해결할 수 있습니다.
年収訴求