Python venv 가상환경 사용법

venv는 파이썬 프로젝트마다 독립된 환경을 만들어 패키지 충돌을 방지한다. 프로젝트별로 필요한 패키지만 설치해서 관리하기 때문에 개발 환경이 깔끔해진다.

기본 사용법

venv를 사용하려면 먼저 프로젝트 디렉토리에서 가상환경을 생성한다.

python3 -m venv .venv # ".venv" 대신 원하는 이름 사용 가능

.venv 디렉토리가 생성되고, 여기에 파이썬 실행 파일과 pip이 설치된다. .venv 이름은 관례적인 것이고 다른 이름도 가능하다. .gitignore 파일에 추가하여 버전 관리에서 제외하는 것이 일반적이다.

가상환경을 활성화하려면 다음 명령어를 실행한다.

source .venv/bin/activate  # Linux/Mac
# Windows: .venv\Scripts\activate

활성화되면 터미널 프롬프트 앞에 (.venv)가 표시된다. 이제 pip install로 패키지를 설치하면 가상환경에만 설치된다.

pip install requests

가상환경을 비활성화하려면 deactivate 명령어를 실행한다.

deactivate

venv가 제대로 안 될 때

가끔 가상환경이 제대로 활성화되지 않거나, 패키지가 설치되지 않는 경우가 있다. 몇 가지 해결 방법이 있다.

• 파이썬 버전 확인: python3 명령어가 올바른 파이썬 버전을 가리키는지 확인한다. 시스템에 여러 버전의 파이썬이 설치되어 있다면 문제가 발생할 수 있다. which python3 또는 where python (Windows) 명령어로 확인한다.
• pip 업데이트: pip 버전이 너무 낮으면 최신 패키지를 설치하지 못할 수 있다. 다음 명령어로 pip를 최신 버전으로 업데이트한다.

python -m pip install --upgrade pip

• 가상환경 삭제 후 재설치: 가상환경이 손상되었을 수도 있다. .venv 디렉토리를 삭제하고 다시 생성한다.

rm -rf .venv # Windows: rmdir /s .venv
python3 -m venv .venv
source .venv/bin/activate # Linux/Mac. Windows는 .venv\Scripts\activate

• 절대 경로 사용: 쉘 설정에 따라 가상환경 활성화 스크립트 실행 시 문제가 생길 수 있다. 스크립트의 절대 경로를 사용해본다.

source /absolute/path/to/.venv/bin/activate