uv를 통한 Python 프로젝트 구성

Python 버전 관리, 의존성 관리, 가상환경 관리 등 통합 프로젝트 관리 도구인 uv를 사용하면 Python 프로젝트를 매우 쉽게 관리할 수 있다. 게다가 아래 표에서 확인할 수 있다시피 uv는 의존성 주입 등 환경 구성이 매우 빠르게 수행되는 장점이 있다.

---

설치

uv는 기본적으로 아래와 같은 명령어로 설치가 가능하다. 최신 설치 방법은 공식 문서를 참고하자.

Windows

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

주요 명령어

Python 버전 관리

• Python 설치/삭제

uv python install {PYTHON_VERSION}

uv python uninstall {PYTHON_VERSION}

• 사용 가능한 Python 버전 확인

uv python list

프로젝트 관리

• 프로젝트 시작

uv init

• 의존성 패키지 주입/삭제

uv add

uv add {PACKAGE_NAME}

uv add -r requirements.txt

uv remove

• 가상환경을 포함한 프로젝트 의존성을 환경 설정에 동기화

uv sync

• 프로젝트 의존성 관리를 위한 lockfile 생성

uv lock

---

Reference

• uv