본문 바로가기
08.개발&프로그래밍/1.파이썬

8. Python 가상환경 & 패키지 관리 가이드 (venv + pip)

by JWJ Family 2025. 7. 12.
728x90

venv로 프로젝트별 가상환경을 만들고, pip로 패키지를 설치한 뒤 requirements.txt로 관리하는 방법을 예제로 정리했습니다.

1. 가상환경(venv) 생성

# 프로젝트 폴더에서 실행
python3 -m venv .venv

`.venv` 폴더에 독립된 파이썬 환경을 생성합니다. 일반적으로 프로젝트마다 별도 생성을 권장합니다 :contentReference[oaicite:4]{index=4}.

2. 가상환경 활성화

# macOS/Linux
source .venv/bin/activate

# Windows
.venv\Scripts\activate

활성화 후, 프롬프트에 `(venv)`가 표시되고, pip/파이썬이 환경 내에서 실행됩니다.

3. pip로 패키지 설치 및 업데이트

(venv) $ pip install requests
(venv) $ python -m pip install --upgrade pip

`venv` 활성 상태에서 패키지 설치/업데이트하면 전역 환경을 오염시키지 않습니다.

4. requirements.txt 관리

(venv) $ pip freeze > requirements.txt

# 새 환경에서 사용:
$ python -m venv .venv
$ source .venv/bin/activate
(venv) $ pip install -r requirements.txt

이렇게 하면 다른 사람도 동일한 환경을 손쉽게 재현할 수 있습니다.

5. 가상환경 제거 & 재생성

(venv) $ deactivate
$ rm -rf .venv
# 필요 시 재생성 가능

`.venv` 폴더를 삭제하면 환경이 완전히 사라지며, 언제든지 재생성할 수 있습니다.

요약 및 다음 글 예고

  • venv로 프로젝트별 가상환경 생성 후 활성화
  • pip로 패키지 설치/업데이트
  • requirements.txt로 의존성 관리
  • 가상환경 삭제 후 재생성 가능

🎯 다음 글에서는 9. 유닛 테스트와 코드 품질 관리(unittest)를 다룰 예정이니 많은 기대 부탁드립니다!

반응형