리눅스에서 Python 가상환경 설정하는 방법 – venv

목차

1. 패키지 충돌, 왜 생기는 걸까?
2. 가상환경(Virtual Environment)이란?
3. venv로 가상환경 만들기
4. 가상환경 활성화와 비활성화
5. 패키지 설치 및 requirements.txt 관리
6. 서버에서 가상환경 사용하기
7. 정리 및 다음 단계

1. 패키지 충돌, 왜 생기는 걸까?

Python 프로젝트를 여러 개 운영하다 보면 이런 상황이 생깁니다. 프로젝트 A는 Django 3.2가 필요하고, 프로젝트 B는 Django 4.2가 필요합니다. 시스템에 두 버전을 동시에 설치할 수 없습니다.

또는 팀원과 함께 개발하는데 각자 컴퓨터의 패키지 버전이 달라 내 컴퓨터에서는 잘 돌아가는 코드가 팀원 컴퓨터에서는 오류가 나는 상황도 생깁니다.

이 문제를 해결하는 것이 **가상환경(Virtual Environment)**입니다.

2. 가상환경(Virtual Environment)이란?

가상환경은 프로젝트마다 독립적인 Python 환경을 만드는 기술입니다. 각 가상환경은 자신만의 Python 인터프리터와 패키지를 가집니다.

원룸 비유로 설명하면, 같은 건물(컴퓨터)에 있지만 각 원룸(가상환경)은 독립된 공간입니다. 201호에는 Django 3.2가 설치되어 있고, 202호에는 Django 4.2가 설치되어 있어도 서로 충돌하지 않습니다.

Python 3.3 이상에는 venv 모듈이 기본으로 내장되어 있어 별도 설치 없이 사용할 수 있습니다.

3. venv로 가상환경 만들기

프로젝트 디렉토리로 이동합니다.

cd /home/ubuntu/myproject

가상환경을 만듭니다. venv 뒤의 이름은 가상환경 폴더 이름입니다. 관례적으로 venv 또는 .venv를 사용합니다.

python3 -m venv venv

명령 실행 후 myproject/venv 폴더가 생성됩니다. 이 폴더 안에 Python 인터프리터와 패키지가 저장됩니다.

4. 가상환경 활성화와 비활성화

가상환경을 만들었다고 자동으로 적용되지 않습니다. 사용할 때마다 활성화해야 합니다.

Linux/Mac에서 활성화

source venv/bin/activate

활성화되면 터미널 프롬프트 앞에 (venv)가 표시됩니다.

(venv) ubuntu@server:~/myproject$

가상환경 비활성화

deactivate

비활성화하면 (venv) 표시가 사라지고 시스템 기본 Python 환경으로 돌아갑니다.

5. 패키지 설치 및 requirements.txt 관리

가상환경이 활성화된 상태에서 pip로 패키지를 설치합니다.

pip install django pip install requests flask

설치된 패키지 목록을 확인합니다.

pip list

현재 설치된 패키지 목록을 requirements.txt 파일로 저장합니다. 다른 환경에서 동일한 패키지를 설치할 때 사용합니다.

pip freeze > requirements.txt

requirements.txt를 기반으로 패키지를 일괄 설치합니다. 팀원이 프로젝트를 clone한 후 이 명령으로 동일한 환경을 만들 수 있습니다.

pip install -r requirements.txt

6. 서버에서 가상환경 사용하기

서버에 코드를 배포할 때도 가상환경을 사용하는 것이 권장됩니다.

서버에서 프로젝트 폴더로 이동 후 가상환경을 만듭니다.

cd /home/ubuntu/myproject python3 -m venv venv

가상환경을 활성화하고 패키지를 설치합니다.

source venv/bin/activate pip install -r requirements.txt

앱을 실행할 때도 가상환경이 활성화된 상태에서 실행합니다.

systemd 서비스로 앱을 관리할 때는 서비스 파일에 가상환경 Python 경로를 직접 지정합니다.

ExecStart=/home/ubuntu/myproject/venv/bin/python app.py

이렇게 하면 가상환경을 수동으로 활성화하지 않아도 가상환경의 Python과 패키지를 사용합니다.

7. 정리 및 다음 단계

오늘 배운 핵심을 정리합니다.

• 가상환경은 프로젝트마다 독립적인 Python 패키지 환경을 만드는 기술입니다.
• python3 -m venv venv로 생성하고 source venv/bin/activate로 활성화합니다.
• pip freeze > requirements.txt로 패키지 목록을 저장하고 pip install -r requirements.txt로 동일 환경을 재현합니다.
• 서버 배포 시에도 가상환경 사용을 권장합니다.

다음 글에서는 TCP와 UDP의 차이, 개발자가 꼭 알아야 할 네트워크 기초를 알아보겠습니다.