Python

uv를 이용한 파이썬 가상환경 관리

Pro.Dev 2025. 3. 25. 14:59
반응형

uv를 이용한 파이썬 가상환경 관리

파이썬 개발 환경을 관리하는 데 있어 uv는 최근 주목받고 있는 도구입니다. uv는 빠르고 효율적인 파이썬 버전 관리와 가상환경 생성을 지원하며, 기존의 pip, venv, poetry 등의 도구를 대체할 수 있는 기능을 제공합니다. 이 글에서는 uv를 사용하여 파이썬 가상환경을 생성하고 관리하는 방법에 대해 설명합니다.

uv란 무엇인가?

uv는 Rust로 작성된 빠른 Python 패키지 및 프로젝트 관리자입니다. uv는 기존의 도구들보다 더 빠른 성능과 간편한 사용법을 제공하여 개발자들이 프로젝트 관리에 소요되는 시간을 줄일 수 있도록 돕습니다.

 

각 컴퓨터에 uv를 설치하는 방법을 알려드리겠습니다. 운영 체제별로 설치 방법이 다릅니다:

Windows:

 
text
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

macOS/Linux:

 
text

이 명령어들은 uv를 시스템 전역에 설치합니다27. 설치가 완료되면 터미널을 재시작하여 PATH에 uv가 추가되도록 합니다.

 

uv를 사용하여 파이썬 가상환경 생성

uv를 사용하여 특정 버전의 파이썬 가상환경을 생성하는 방법은 다음과 같습니다:

 
bash
uv venv --python 3.10 .venv

이 명령어는 현재 디렉토리에 Python 3.10 버전의 가상환경을 생성합니다.

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

가상환경을 활성화하려면 다음 명령어를 사용합니다:

  • Windows:
 
bash
.venv\Scripts\activate
  • Linux/macOS:
 
bash
source .venv/bin/activate

가상환경을 비활성화하려면:

 
bash
deactivate

uv로 파이썬 라이브러리 설치

uv를 사용하여 파이썬 라이브러리를 설치하려면 다음 명령어를 사용합니다:

 
bash
uv add <패키지명>

예를 들어, requests 라이브러리를 설치하려면:

 
bash
uv add requests

uv로 프로젝트 초기화

uv를 사용하여 새로운 프로젝트를 초기화하려면 다음 명령어를 사용합니다:

 
bash
uv init 프로젝트명

이 명령어는 프로젝트 폴더를 생성하고 기본적인 파일 구조를 설정합니다.

uv로 현재 가상환경의 파이썬 버전 확인

현재 활성화된 가상환경의 파이썬 버전을 확인하려면 다음 명령어를 사용합니다:

 
bash
python --version

uv로 파이썬 스크립트 실행

uv를 사용하여 파이썬 스크립트를 실행하려면 다음 명령어를 사용합니다:

 
bash
uv run app.py

이 명령어는 현재 프로젝트의 가상환경 내에서 app.py 파일을 실행합니다.

반응형