uv에서 가상환경 사용하기

가상환경 생성

기본적으로 .venv 디렉토리에 가상환경이 생성된다.

uv venv

 

특정 이름이나 경로로 가상환경을 생성하려면 다음과 같이 실행한다.

uv venv my-env

 

특정 Python 버전을 지정하여 가상환경을 생성할 수도 있다.

uv venv --python 3.11

이 명령어는 지정한 버전의 Python을 설치하고 해당 버전으로 가상환경을 생성

---

가상환경 활성화

생성된 가상환경을 활성화하려면 아래의 명령어를 사용

• macOS/Linux

source .venv/bin/activate

 

• Windows

.venv\Scripts\activate

 

---

가상환경 내에서 패키지 설치

가상환경이 활성화된 상태에서 패키지를 설치하려면 uv pip 명령어를 사용한다.

uv pip install requests

 

또는 uv add 명령어를 사용하여 의존성을 추가할 수 있다.

uv add requests

 

이렇게 하면 pyproject.toml 파일에 의존성이 추가되고, 가상환경에 해당 패키지가 설치된다.

---

uv 가상환경 관리 장점

• 속도: uv venv는 pyhton -m venv보다 최대 80배, virtualenv보다 7배 빠르게 가상환경을 생성한다.
• 통합 관리: 가상환경 생성, 패키지 설치, Python 버전 관리 등을 하나의 도구로 통합하여 관리할 수 있다.​
• 자동 감지: uv run, uv sync 등의 명령어를 사용할 때, .venv 디렉토리가 존재하면 자동으로 해당 가상환경을 사용한다.​

---

추가 팁: VSCode에서 사용하기

VSCode에서 uv로 생성한 가상환경을 사용하려면 다음과 같이 설정할 수 있다.

1. VSCode의 명령 팔레트를 열고 (Ctrl+Shift+P), Python: 인터프리터 선택
2. 목록에서 .venv 디렉토리의 Python 인터프리터를 선택한다.​
3. 만약 목록에 나타나지 않는다면, 인터프리터 경로 입력을 선택하고 .venv/bin/python (Windows의 경우 .venv\Scripts\python.exe) 경로를 직접 입력한다.