가상환경 사용법

가상환경으로 Python 설치환경 격리하는 방법

Python 가상환경¶

Python은 라이브러리 버전 관리가 중요하기 때문에 프로젝트 별로 별도의 가상환경을 구축해서 사용하는 것이 좋다. venv, pipenv, pyenv, conda 등 여러 가지 라이브러리를 통해서 가상환경을 구축할 수 있는데, 나는 Python3.3 버전 이후부터 기본 모듈로 제공되는 venv를 사용한다.

Windows에서¶

1. venv로 가상환경 만들고 실행¶

python -m venv 명령어로 파이썬 가상환경을 만든다.

python -m venv [venv_name]

가상환경을 구동하려면 생성한 가상환경의 \Scripts\activate.bat을 실행시킨다.

Scripts\activate.bat

가상환경이 정상적으로 실행되면 아래와 같이 터미널에 가상환경 이름이 표시된다.

(venv_name) C:\>

가상환경을 중지하려면 deactivate를 입력하거나 Scripts\deactivate.bat를 실행하면 된다.

deactivate

Scripts\deactivate.bat

2. ⚡특정 Python version 사용¶

프로젝트를 하다보면 여러 가지 이유로 특정 Python 버전을 사용해서 작업을 해야한다. 이런 경우에는 아래 명령어와 같이 사용할 파이썬 버전의 실행파일 위치를 지정해서 특정 버전의 Python을 사용하도록 하면 된다.

[your_python_location] -m venv [venv_name]

내 세팅의 개발환경에서는 아래와 같은 명령어로 만들 수 있다.

C:\programming\Python\Python310\python.exe -m venv .venv

Info

여러 버전의 Python을 설치하면 시스템 환경 변수를 기준으로 가장 위에 있는 Python이 default로 사용 된다.

3. package 목록 관리¶

3-1. 라이브러리 목록 생성¶

설치된 라이브러리 버전을 저장해서 파일로 생성 및 관리하는 방법으로, 위의 Python 버전 관리와 함께 가상환경을 사용하는 이유다.

_{나는 이 방법을 모르는 두 사람이 라이브러리들의 이름과 버전을 복창하면서 지적확인하는 것을 본 적이 있다..}

아래와 같이 입력하면 라이브러리 리스트 파일을 생성한다. 일반적으로 requirements.txt파일로 생성하지만 다른 이름으로도 만들 수 있으며, ./requirements/ 디렉토리에 용도별(개발용/배포용/서버용 등)로 나누어서 라이브러리를 관리할 수도 있다.

pip freeze > requirements.txt

3-2. 라이브러리 목록 전체 설치/삭제¶

위에서 만든 requirements.txt의 목록대로 라이브러리를 설치하는 명령어는 아래와 같다.

pip install -r requirements.txt

requirements.txt의 목록대로 라이브러리를 삭제하는 명령어는 아래와 같다.

pip uninstall -r requirements.txt

Tip

이때 모든 라이브러리에 대해 하나하나 삭제 확인 명령을 내려줘야 하기 때문에 매우 귀찮은데, 아래와 같이 -y 옵션을 사용하면 추가 확인 없이 삭제한다.

pip uninstall -r requirements.txt -y

4. 라이브러리 버전 관리¶

4-1. 특정 버전의 라이브러리 설치¶

특정 버전의 라이브러리를 설치하고 싶을 때는 아래와 같이 명령어를 입력하면 된다. 라이브러리 간의 호환성이 중요한 경우나 신버전의 라이브러리에서 삭제된 구버전 기능을 사용하고 싶을 경우 사용한다.

pip install [library_name]==[version]

4-2. 라이브러리 업그레이드¶

라이브러리를 업그레이드하고 싶을 때는 아래와 같이 명령어를 입력하며 된다.

pip install --upgrade [library_name]

특정 버전으로 업그레이드하려면 아래와 같이 조합하면 된다.

pip install --upgrade [library_name]==[version]

4-3. 라이브러리 다운그레이드¶

라이브러리 간의 호환성 문제로 다운그레이드 할 때는 라이브러리를 삭제하고 재설치 하면 된다.

아래와 같이 --force-reinstall을 통해 강제로 삭제하고 재설치하는 방법도 있다.

pip install [library_name]==[version] --force-reinstall

5. 그 외 알아두면 좋은 팁들¶

5-1. 특정 Python 버전 실행¶

.py파일을 특정 Python 버전으로 실행시키고 싶을 경우, 아래 명령어처럼 하면 된다고 한다.

py -version .py

pip을 사용할 경우 아래 명령어처럼 하면 된다고 한다.

py -version -m pip install virtualenv

명백하게도, 가상환경을 사용하는 편이 훨씬 쉽고 안정적이다. 특히 여러 프로젝트를 한 컴퓨터에서 동시에 작업하고 있다면 더더욱 그렇다.

5-2. 가상환경 삭제¶

Python 가상환경을 삭제하는 별도의 명령어는 없다. 필요한 내용만 백업하고 폴더째로 지우면 된다.

5-3. 파이썬 가상환경 옮기기¶

파일 이동 후 아래 세 파일들의 내용을 수정하면 된다고 한다.

Warning

절대 추천하지 않는다. 필요한 파일들만 백업한 후 원하는 위치에 가상환경을 비롯한 프로젝트 세팅을 처음부터 진행하는 것이 좋다.

activate
activate.bat
Activate.ps1

VIRTUAL_ENV=venv_location_b4 -> VIRTUAL_ENV=venv_location_now

~~직접 해보지 않아서 잘 되는지 모르겠다. 사실 시도해보고 싶지도 않다.~~

5-4. VS Code에서 가상환경이 제대로 인식되지 않을 때¶

가끔 캐시 문제 등으로 VS Code에서 가상환경이 제대로 인식되지 않는 경우가 있다. 이 때는 아래 방법으로 캐시를 지우고 환경을 리로딩하면 된다.

Ctrl+Shift+P 로 명령 프롬프트 열기
Python: Clear Cache and Reload 명령 실행

Linux에서¶

대부분 Windows와 다를바 없으니 차이점만 작성하기로 한다.

1. 준비물¶

Ubuntu 업데이트

sudo apt update && sudo apt upgrade

python3 업데이트

sudo apt upgrade python3

python3-pip 설치

sudo apt install python3-pip

python3-venv 설치

sudo apt-get install python3-venv

2. ⚡특정 Python version 사용¶

* 위치에 사용하고 싶은 파이썬 버전 입력 (e.g. python3.7)

python* -m venv [venv_name]

3. 가상환경 실행¶

linux에서 Python 가상환경을 실행하는 명령어는 아래와 같다.

source bin/activate

Reference¶

Python Documentation: Virtual Environments and Packages(한글)