Python 가상환경(venv) 사용법

개발 가이드 / python-venv.html

프로젝트마다 독립된 패키지 공간을 만들어, 버전 충돌과 전역 설치 문제를 줄이는 방법입니다.

💬 프로젝트마다 자기만의 패키지 방을 갖게 하는 것이 가상환경입니다.

전역(시스템)에 설치하면 다른 프로젝트와 버전이 충돌합니다. 가상환경을 쓰면 프로젝트별로 필요한 버전을 자유롭게 설치할 수 있습니다.

만들기와 활성화

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

# 활성화
source .venv/bin/activate      # macOS / Linux
.venv\Scripts\activate        # Windows

# 이제 설치한 패키지는 이 환경에만 들어갑니다
python -m pip install requests

종료

deactivate

자주 겪는 문제

• pip install 이 권한 오류: 전역에 설치하려 할 때 발생합니다. 가상환경이 켜졌는지(which python) 확인하세요.
• 다시 켜니 패키지가 없음: 활성화를 안 한 상태입니다. 프롬프트에 (.venv)가 보이는지 확인하세요.

검증일은 자료의 최신성을 나타냅니다. 오래된 자료는 적용 조건을 확인하세요.