명령어

개요

uv CLI는 Python 프로젝트, 의존성(dependency), 환경, 패키지(package) 배포를 관리하는 포괄적인 명령어 집합을 제공합니다. 이 레퍼런스는 사용 가능한 모든 명령어와 옵션을 설명합니다.

핵심 명령어

uv auth — 서비스의 인증 자격증명을 관리합니다 - uv auth login — 서비스에 인증합니다 - uv auth logout — 저장된 자격증명을 제거합니다 - uv auth token — 저장된 인증 토큰을 조회합니다 - uv auth dir — 자격증명 디렉터리 위치를 표시합니다

uv run — Python 환경에서 명령어 또는 스크립트를 실행합니다. 인라인 메타데이터 스크립트의 경우 의존성을 자동으로 설치합니다

uv init — pyproject.toml 명세에 따라 새 프로젝트를 생성합니다

uv add — 프로젝트 설정에 의존성을 추가하고 락파일(lockfile)과 환경을 자동으로 갱신합니다

uv remove — 프로젝트 설정에서 의존성을 삭제합니다

uv version — 프로젝트 버전 정보를 조회하거나 수정합니다

uv sync — 락파일 명세에 맞게 프로젝트 환경을 갱신합니다

uv lock — 프로젝트 락파일을 생성하거나 갱신합니다

uv export — 락파일을 다른 형식(예: requirements.txt)으로 변환합니다

uv tree — 의존성 계층 구조를 시각화합니다

uv format — Python 파일에 코드 포매팅을 적용합니다

uv check — 프로젝트 유효성 검사를 실행합니다

uv audit — 알려진 보안 취약점을 의존성에서 검사합니다

패키지 관리

uv tool — 격리된 도구(tool) 설치를 관리합니다 - uv tool run — 영구 설치 없이 도구를 실행합니다 - uv tool install — 시스템에 도구를 추가합니다 - uv tool upgrade — 설치된 도구를 업데이트합니다 - uv tool list — 설치된 도구 목록을 표시합니다 - uv tool uninstall — 도구를 제거합니다 - uv tool update-shell — 셸 통합을 설정합니다 - uv tool dir — 도구 디렉터리를 표시합니다

uv pip — pip 호환 패키지 인터페이스 - uv pip compile — 잠긴(locked) 요구사항을 생성합니다 - uv pip sync — 정확한 패키지 집합을 설치합니다 - uv pip install — 환경에 패키지를 추가합니다 - uv pip uninstall — 패키지를 제거합니다 - uv pip freeze — 설치된 패키지를 내보냅니다 - uv pip list — 설치된 패키지 목록을 표시합니다 - uv pip show — 패키지 메타데이터를 표시합니다 - uv pip tree — 패키지 의존성을 시각화합니다 - uv pip check — 환경 일관성을 검증합니다

uv python — Python 버전을 관리합니다 - uv python list — 사용 가능한 버전 목록을 표시합니다 - uv python install — 버전을 다운로드하고 설치합니다 - uv python upgrade — 설치된 버전을 업데이트합니다 - uv python find — Python 인터프리터 위치를 찾습니다 - uv python pin — 프로젝트 Python 버전을 설정합니다 - uv python dir — Python 설치 디렉터리를 표시합니다 - uv python uninstall — 설치된 버전을 제거합니다 - uv python update-shell — 셸 통합을 설정합니다

프로젝트 및 빌드

uv venv — 격리된 가상환경(virtual environment)을 생성합니다

uv build — 배포 아티팩트(wheel 및 소스 배포판)를 생성합니다

uv publish — 패키지 레지스트리(registry)에 배포판을 업로드합니다

uv workspace — 다중 프로젝트 워크스페이스(workspace)를 검사합니다 - uv workspace metadata — 워크스페이스 정보를 표시합니다 - uv workspace dir — 워크스페이스 루트를 표시합니다 - uv workspace list — 워크스페이스 멤버 목록을 나열합니다

유지관리

uv cache — 패키지 캐시(cache)를 관리합니다 - uv cache clean — 캐시된 데이터를 제거합니다 - uv cache prune — 미사용 캐시 항목을 제거합니다 - uv cache dir — 캐시 위치를 표시합니다 - uv cache size — 캐시 디스크 사용량을 표시합니다

uv self — uv 설치를 유지관리합니다 - uv self update — uv 실행 파일을 업그레이드합니다 - uv self version — 설치된 버전을 표시합니다

uv generate-shell-completion — 셸 자동완성 스크립트를 생성합니다

uv help — 명령어 문서를 표시합니다

주요 옵션

대부분의 명령어에서 사용 가능한 공통 플래그:

• --frozen — 락파일을 갱신하지 않고 사용합니다
• --locked — 락파일이 최신 상태여야 합니다
• --offline — 네트워크 접근을 비활성화합니다
• --no-cache — 캐시 작업을 건너뜁니다
• --directory — 작업 디렉터리를 변경합니다
• --project — 프로젝트 루트를 지정합니다
• --python — Python 인터프리터를 선택합니다
• --index — 패키지 레지스트리 URL을 지정합니다
• --default-index — 기본 패키지 인덱스를 설정합니다
• --allow-insecure-host — 검증되지 않은 HTTPS 연결을 허용합니다
• --verbose / --quiet — 출력 상세도를 제어합니다
• --color — 컬러 출력을 설정합니다

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

원문(영어): https://docs.astral.sh/uv/reference/cli/