Python 환경 사용하기

각 Python 설치에는 패키지를 설치할 수 있는 활성 환경이 있습니다. 특히 시스템 수준 Python의 경우 Python 설치의 기본 환경을 수정하는 대신, 격리를 위해 가상환경(virtual environment)을 사용하는 것이 권장됩니다.

가상환경 만들기

기본 명령어는 .venv 위치에 가상환경을 생성합니다.

$ uv venv

사용자 정의 위치를 지정할 수 있습니다.

$ uv venv my-name

특정 Python 버전을 요청할 수도 있습니다.

$ uv venv --python 3.11

요청한 버전이 로컬에 없으면 uv가 자동으로 다운로드합니다.

가상환경 사용하기

기본 이름인 .venv를 사용하면 uv가 이후 명령어에서 자동으로 해당 환경을 찾아 사용합니다.

$ uv venv
$ # 새 가상환경에 패키지 설치
$ uv pip install ruff

환경을 활성화하여 패키지에 직접 접근하려면 셸에 맞는 활성화 스크립트를 사용합니다.

macOS 및 Linux:

$ source .venv/bin/activate

Windows:

PS> .venv\Scripts\activate

그 외 셸:

$ source .venv/bin/activate.fish      # fish
$ source .venv/bin/activate.csh       # csh / tcsh
$ use .venv\Scripts\activate.nu       # Nushell

환경 비활성화

활성화된 환경을 종료하려면 다음을 실행합니다.

$ deactivate

임의 Python 환경 사용하기

uv는 VIRTUAL_ENV 변수를 PEP 405 호환 가상환경 경로로 설정하면 자체 환경 외부의 환경에도 설치할 수 있습니다.

가상환경이 아닌 환경에는 --python 플래그를 사용합니다.

uv pip install --python /path/to/python

시스템 Python 설치에 사용하려면 다음과 같이 합니다.

uv pip install --system

--system 플래그는 비가상 Python 환경을 수정할 때 필요하며, CI/CD 및 컨테이너 환경에 적합합니다.

Python 환경 탐색 순서

uv pip sync나 uv pip install 같은 변경 명령어를 실행할 때 uv는 다음 순서로 가상환경을 탐색합니다.

1. VIRTUAL_ENV 변수로 활성화된 환경
2. CONDA_PREFIX로 활성화된 Conda 환경
3. 현재 또는 가장 가까운 상위 디렉터리의 .venv 디렉터리

아무것도 없으면 uv가 uv venv를 통해 생성하도록 안내합니다.

--system이 포함되면 uv는 가상환경 탐색을 건너뛰고 설치된 Python 버전을 대신 탐색합니다.

원문(영어): https://docs.astral.sh/uv/pip/environments/ · 본 문서는 학습용 한국어 번역이며 원본의 권리는 원저작자(Astral)에게 있습니다.

원문(영어): https://docs.astral.sh/uv/pip/environments/