uv 사용법

728x90

주요 요약

uv는 Rust로 작성된 빠른 Python 패키지 관리자로, pip의 대체제로 사용 가능합니다.
pip install -r requirements.txt 대신 uv pip sync requirements.txt 명령어를 사용하세요.
설치 방법은 pip, pipx, Homebrew, 또는 설치 스크립트를 통해 가능합니다.

uv 설치 방법

uv를 설치하려면 다음 방법 중 하나를 선택하세요:

pip 사용: pip install uv
pipx 사용: pipx install uv
Homebrew (macOS): brew install uv
직접 설치 스크립트:
- macOS/Linux: curl -LsSf https://astral.sh/uv/install.sh | sh
- Windows: powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

requirements.txt로 패키지 설치

requirements.txt 파일에 나열된 패키지를 설치하려면 터미널에서 다음 명령어를 실행하세요:

$ uv pip sync requirements.txt

이 명령은 파일에 나열된 모든 패키지를 빠르고 효율적으로 설치합니다.

상세 보고서: uv 사용 가이드

소개

uv는 2024년 2월에 출시된 Rust로 작성된 Python 패키지 및 프로젝트 관리 도구로, 기존 도구인 pip, pip-tools, virtualenv를 대체할 수 있는 강력한 대안입니다. 특히, 속도 면에서 pip보다 10-100배 빠르며, 효율적인 의존성 관리와 디스크 공간 최적화를 제공합니다. 이 보고서는 uv의 설치 방법, 가상 환경 생성, 그리고 requirements.txt 파일을 통한 패키지 설치에 대해 자세히 설명합니다. 현재 시간은 2025년 4월 17일 오전 12시 7분 PDT로, 최신 정보에 기반한 가이드를 제공합니다.

uv의 배경 및 장점

uv는 Astral에서 개발되었으며, Python 생태계에서 빠르고 신뢰할 수 있는 도구를 제공하기 위해 설계되었습니다. 주요 장점은 다음과 같습니다:

속도: 캐시가 있는 경우 pip보다 80-115배 빠른 성능을 보입니다 (UV vs. PIP: Revolutionizing Python Package Management).
효율성: 전역 모듈 캐시를 사용하여 의존성 재다운로드를 방지하고, Copy-on-Write 및 하드링크를 통해 디스크 공간을 절약합니다.
호환성: pip, pip-tools, virtualenv를 대체하며 기존 워크플로우에 쉽게 통합됩니다.

이 도구는 특히 대규모 프로젝트나 복잡한 의존성 관리에서 유용하며, Python 개발자들에게 현대적인 솔루션을 제공합니다.

설치 방법

uv를 설치하는 방법은 운영 체제와 선호도에 따라 다양합니다. 아래 표는 각 설치 방법을 요약한 것입니다:

방법명령어

pip 사용	pip install uv
pipx 사용	pipx install uv
Homebrew (macOS)	brew install uv
직접 설치 스크립트 (macOS/Linux)	`curl -LsSf https://astral.sh/uv/install.sh
직접 설치 스크립트 (Windows)	`powershell -c "irm https://astral.sh/uv/install.ps1

설치 후, uv --version 명령어로 설치가 제대로 되었는지 확인할 수 있습니다. 설치 방법은 uv PyPI 페이지에서 더 자세히 확인할 수 있습니다.

가상 환경 생성

Python 프로젝트를 시작하기 전에 가상 환경을 생성하는 것이 권장됩니다. uv를 사용하면 간단한 명령어로 가상 환경을 생성할 수 있습니다:

bash

Copy

uv venv

이 명령은 현재 디렉토리에 .venv라는 이름의 가상 환경을 생성합니다. 활성화 방법은 운영 체제에 따라 다릅니다:

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

활성화 후, 프로젝트의 의존성을 격리된 환경에서 관리할 수 있습니다. 이 과정은 uv 공식 문서에서 더 자세히 설명됩니다.

requirements.txt를 통한 패키지 설치

사용자가 요청한 주요 기능은 pip install -r requirements.txt를 대체하는 명령어입니다. uv에서는 다음 명령어를 사용합니다:

bash

Copy

uv pip sync requirements.txt

이 명령은 requirements.txt 파일에 나열된 모든 패키지를 해결하고 설치하며, pip보다 훨씬 빠른 성능을 제공합니다. 예를 들어, 43개의 패키지를 11ms에 해결하고 208ms에 설치하는 사례가 보고되었습니다 (uv PyPI 페이지).
이 명령은 기존 pip 워크플로우와 호환되며, 추가 설정 없이 바로 사용할 수 있습니다. 더 자세한 사용법은 pip 인터페이스 문서를 참조하세요.

추가 기능 및 팁

uv는 단순히 패키지 설치뿐만 아니라 다양한 고급 기능을 제공합니다:

의존성 버전 오버라이드: 특정 버전을 강제로 설치할 수 있습니다.
재현 가능한 해결: 동일한 환경에서 항상 동일한 의존성을 보장합니다.
플랫폼 독립적 해결: 다양한 운영 체제에서 동일한 의존성 파일을 사용할 수 있습니다.

또한, uv는 단일 바이너리로 제공되어 Python 버전에 상관없이 설치가 간단하며, 여러 Python 버전 간의 pip 관리 문제를 해결합니다 (UV: Python packaging in Rust).

결론

uv는 Python 개발자들에게 빠르고 효율적인 패키지 관리 솔루션을 제공하며, 특히 requirements.txt를 통한 패키지 설치에서 기존 pip보다 우수한 성능을 보입니다. 이 가이드를 따라 uv를 설치하고, 가상 환경을 생성하며, 패키지를 관리하면 프로젝트 관리가 더 쉬워질 것입니다. 최신 정보와 추가 기능은 uv 공식 문서에서 확인하세요.

주요 인용