[PYTHON] virtualenv로 파이썬 가상환경을 구성하는 완벽 가이드

[PYTHON] virtualenv

1. virtualenv란 무엇인가?

virtualenv는 파이썬 프로젝트마다 독립된 환경을 만들어주는 툴입니다. 각 프로젝트에서 사용하는 파이썬 버전과 패키지를 분리함으로써 의존성 충돌을 방지하고, 운영 환경과 개발 환경을 일치시키는 데 큰 도움이 됩니다. virtualenv는 특히 다양한 파이썬 프로젝트를 동시에 관리해야 하는 개발자에게 필수 도구입니다. 프로젝트마다 요구되는 패키지 버전이 다를 경우, 시스템 전체에 영향을 주지 않고 독립적으로 환경을 유지할 수 있습니다.

2. virtualenv 설치 및 기본 사용법

pip install virtualenv

virtualenv 설치는 위 명령어 한 줄로 간단히 완료됩니다. 이후, 다음 명령어로 가상환경을 생성합니다.

virtualenv venv

이 명령어는 현재 디렉토리에 venv라는 이름의 폴더를 생성하고, 그 안에 파이썬 실행 파일과 독립된 패키지 설치 공간을 구성합니다.

3. 가상환경 활성화 및 비활성화

Windows:

venv\Scripts\activate

macOS/Linux:

source venv/bin/activate

활성화된 상태에서는 pip이나 python 명령어가 모두 해당 가상환경을 참조합니다. 종료할 때는 아래 명령어를 사용합니다.

deactivate

4. virtualenv의 특별한 장점

• 의존성 충돌 방지: 프로젝트마다 독립적인 패키지 구성이 가능
• 운영 환경 이식성: 동일한 환경을 복제해 배포 가능
• 빠른 세팅: 기존 환경을 유지하면서 신규 프로젝트 즉시 착수
• 테스트 용이성: 다양한 패키지 조합을 실험할 수 있는 안전한 환경

5. virtualenv vs venv vs conda 비교

아래 표는 파이썬에서 사용하는 주요 환경 분리 도구들을 비교한 것입니다.

기능	virtualenv	venv	conda
지원 파이썬 버전	Python 2 & 3	Python 3 이상	Python, R, 기타
환경 복제	지원	제한적	지원
패키지 관리	pip	pip	conda (자체 패키지 매니저)
의존성 해결	기본 pip 기능 사용	기본 pip 기능 사용	자동 의존성 해결 우수
설치 용이성	간편	내장됨	anaconda/miniconda 설치 필요

6. 실전 예제: 프로젝트별 환경 분리

아래는 virtualenv를 이용해 두 개의 프로젝트를 서로 다른 환경에서 설정하는 실전 예시입니다.

# 프로젝트 A
mkdir projectA
cd projectA
virtualenv venv
source venv/bin/activate
pip install django==3.2

# 프로젝트 B
mkdir ../projectB
cd ../projectB
virtualenv venv
source venv/bin/activate
pip install flask==2.0
      

이렇게 하면 프로젝트 A와 B는 서로 독립된 라이브러리를 갖고 실행됩니다.

7. 팁: requirements.txt로 환경 관리

가상환경을 구성한 뒤, 사용 중인 패키지를 저장하고 복원하려면 다음을 활용합니다.

# 패키지 목록 저장
pip freeze > requirements.txt

# 다른 환경에서 동일 환경 구성
pip install -r requirements.txt
      

8. 자주 묻는 질문

Q. virtualenv를 꼭 써야 하나요?

A. 시스템 파이썬 환경을 오염시키지 않기 위해 가상환경 사용은 사실상 필수입니다.

Q. venv와 virtualenv 중 어떤 걸 써야 하나요?

A. 단순 프로젝트는 venv로 충분하지만, 호환성과 기능이 더 다양한 virtualenv가 좀 더 유연합니다.

9. 마무리

virtualenv는 파이썬 개발자의 환경 구성을 한 차원 높여주는 필수 도구입니다. 프로젝트마다 일관된 환경을 유지하고, 예기치 못한 패키지 충돌에서 자유로워질 수 있습니다. 파이썬을 활용한 개발을 더욱 안정적이고 체계적으로 진행하고 싶다면, 지금 바로 virtualenv를 도입해 보세요.

출처

• virtualenv 공식 문서
• Python 공식 문서 - venv
• Real Python - Virtual Environments