Ubuntu에서 Python 환경 설정 및 패키지 설치 (pip)

Ubuntu에서 Python 환경 구축 및 pip 패키지 관리하기

Ubuntu에서 Python 개발을 시작하려면 먼저 Python 인터프리터를 설치하고, 독립적인 가상환경을 설정한 뒤 pip로 패키지를 관리하는 것이 중요합니다. 이 가이드는 초보자도 따라 하기 쉽게 각 단계를 정리했습니다.

1. Python 인터프리터 설치

Ubuntu 기본 저장소의 Python3를 설치하거나, 최신 버전이 필요할 경우 Deadsnakes PPA를 추가해 업데이트할 수 있습니다.

sudo apt update
sudo apt install -y python3 python3-venv python3-pip
# 최신 Python 설치(옵션)
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install -y python3.10

2. 가상환경(venv) 구성

프로젝트별로 독립된 패키지 관리를 위해 venv 모듈을 사용합니다. 작업 디렉토리에서 아래를 실행해 환경을 생성하고 활성화하세요.

python3 -m venv .venv
source .venv/bin/activate

비활성화는 deactivate 명령어 한 줄이면 됩니다.

3. pip로 패키지 설치 및 관리

pip를 최신 버전으로 업데이트한 뒤 필요한 패키지를 설치합니다. 프로젝트 의존성 관리를 위해 requirements.txt도 함께 활용하세요.

pip install --upgrade pip
pip install flask requests
pip freeze > requirements.txt
# 설치된 패키지 확인
pip list

실무 팁

• requirements 분리: 개발/운영용 패키지를 분리해 requirements-dev.txt로 관리하면 충돌을 예방할 수 있습니다.
• pip 캐시 활용: ~/.cache/pip를 적극 활용해 반복 빌드 속도를 높이고 네트워크 부담을 줄이세요.
• --user 옵션 주의: 전역 설치 대신 가상환경 내 설치를 권장하며, 필요 시에만 --user를 사용하세요.