venv와 함께 쓰는 일상 pip 명령

일반적인 pip 사용에서 가장 중요한 습관은 패키지를 전역 설치하지 않는 것이야. 프로젝트마다 virtual environment(venv)를 만들어 그 안에서 작업해. 자주 쓰는 흐름은 venv 생성과 활성화, 설치, freeze, 실행으로 이어져.

python3 -m venv .venv는 .venv 디렉터리에 virtual environment를 만들어. source .venv/bin/activate로 활성화하면 셸 프롬프트에 (.venv)가 붙고 which python도 venv 안의 실행 파일을 가리켜. 끝낼 때는 deactivate를 실행해.

venv 안에서 pip install <pkg>을 실행하면 패키지가 이 환경에만 설치돼. pip install -r requirements.txt는 requirements 파일을 읽어 설치하고, pip install -e .는 현재 디렉터리를 editable install로 연결해 소스 수정이 곧바로 반영되게 해. Python 패키지 개발의 표준 방식이야.

pip freeze는 설치된 모든 패키지를 name==version 형식으로 출력해. pip이 lockfile에 가장 가까이 가는 기능으로, requirements.txt로 보내 현재 환경을 기록할 수 있어. pip list는 설치된 목록을 표로 보여 주고, pip show <pkg>는 한 패키지의 버전, 위치, 의존성, 홈페이지를 보여 줘. pip uninstall <pkg>는 패키지를 제거하지만 고아가 된 의존성까지 지우지는 않아. 이것이 pip의 지저분한 제거 문제야.

Code

venv부터 시작하는 작업 흐름·bash

# 1. 프로젝트 별 venv
cd my-project
python3 -m venv .venv

# 2. 활성화 (zsh / bash)
source .venv/bin/activate

# 이제 prompt 가 (.venv) 보임; python 과 pip 이 venv 안 가리킴
which python
# /Users/you/my-project/.venv/bin/python

# 3. Install
pip install requests flask

# 4. 상태 캡처
pip freeze > requirements.txt

# 5. 끝나면 deactivate
deactivate

다른 머신에서 재현·bash

# 프로젝트 clone; 팀원 셋업
cd my-project
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

# 이제 같은 패키지 — 그치만 같은 transitive dep 버전은 NOT,
# requirements.txt 가 pip-tools, pip-compile, 또는 uv 같은 진짜
# locking 도구로 생성된 게 아니라면.

라이브러리 개발용 editable install·bash

# Python 패키지 source dir 에서 (pyproject.toml 또는 setup.py 와 함께)
pip install -e .

# 이제 패키지가 이 venv 의 어디에서나 importable,
# 그리고 코드 편집이 즉시 반영 — 재설치 안 필요.
# 라이브러리 개발할 때 표준 워크플로우.

Exercise

임시 디렉터리를 만들고 venv를 생성해 활성화한 뒤 세 패키지를 설치해('pip install requests rich httpx'). 'pip freeze > requirements.txt'를 실행하고 파일을 열어 모든 전이 의존성이 기록된 것을 확인해. 이 평평한 출력이 requirements.txt가 lockfile을 흉내 내는 방식이야.

Code

External links

Exercise

Progress

댓글 0