15강. pip와 가상환경 venv

?1. 이번 강의에서 해결할 문제

모든 패키지를 전역 Python에 설치하면 프로젝트마다 필요한 버전이 충돌합니다. 프로젝트 전용 인터프리터와 패키지 공간을 만듭니다.

✓2. 학습 목표

✓이 강의를 마치면

• venv로 격리된 환경을 생성·활성화합니다.
• 현재 Python과 pip의 경로를 확인합니다.
• python -m pip로 pytest를 설치하고 기록합니다.

◇3. 핵심 개념

가상환경은 프로젝트마다 독립된 Python 실행 경로와 site-packages를 제공합니다. 활성화는 현재 PowerShell의 PATH를 바꾸는 편의 기능입니다. 패키지 설치는 python -m pip로 실행해 지금 선택된 Python과 pip를 일치시킵니다.

</>4. 단계별 코드 예시

환경 경로: C:\dev\game-log-analyzer\.venv

PowerShell · 생성과 활성화

Set-Location C:\dev\game-log-analyzer
py -3.13 -m venv .venv
.\.venv\Scripts\Activate.ps1
python --version
python -c "import sys; print(sys.executable)"
python -m pip install --upgrade pip
python -m pip install pytest
python -m pytest --version
python -m pip freeze | Set-Content -Encoding utf8 requirements.txt

PowerShell 실행 정책으로 활성화가 막히면 시스템 전체 설정을 바꾸기보다 환경의 Python을 직접 실행할 수 있습니다.

PowerShell · 활성화 없는 대안

.\.venv\Scripts\python.exe -m pytest --version

→5. 코드가 동작하는 이유

venv는 기본 Python을 참조하는 격리 환경 구조를 만듭니다. 활성화 후 python은 .venv의 실행 파일을 먼저 찾습니다. freeze는 재설치 가능한 현재 패키지 버전을 텍스트로 기록합니다.

!6. 자주 하는 실수와 해결법

!자주 하는 실수

• 전역 pip 사용: python -m pip와 sys.executable로 대상을 확인합니다.
• .venv를 Git에 커밋: 재생성 가능하므로 .gitignore에 .venv/를 추가합니다.
• 실행 정책을 무조건 낮춤: 활성화가 필수는 아닙니다. 환경의 python.exe를 직접 호출하는 안전한 대안을 사용합니다.

✎7. 직접 실습

✎직접 실습

1. 가상환경 전후의 sys.executable을 비교합니다.
2. pytest를 설치하고 버전을 확인합니다.
3. 새 PowerShell에서 활성화 없이 환경의 Python으로 pytest를 실행합니다.

?8. 이해 점검 질문 3개

?이해 점검

1. 가상환경이 프로젝트 간 어떤 충돌을 줄이나요?
2. python -m pip가 단독 pip보다 명확한 이유는 무엇인가요?
3. PowerShell 활성화가 실패해도 가상환경을 사용할 수 있는 방법은 무엇인가요?

■9. 핵심 요약

■핵심 요약

프로젝트마다 venv를 만들고 그 Python으로 패키지를 설치합니다. 활성화 여부보다 실제 sys.executable과 모듈 실행 대상을 확인하는 습관이 중요합니다.