byteforce

CPN 한국어 자습서 · 외부 문서 한국어 미러

UV 문서 · Getting started

uv 설치

Installing uv · 원문: docs.astral.sh/uv/getting-started/installation/

아래는 원문을 한국어로 옮긴 미러입니다. 코드·명령은 원문 그대로이며, 가장 최신 정보는 하단 원문 링크에서 확인하세요.

설치 방법

uv는 다양한 환경과 선호도에 맞는 여러 설치 방법을 제공합니다.

단독 설치 프로그램

단독 설치 프로그램이 주요 권장 방법입니다. macOS 및 Linux에서는 다음을 실행합니다.

코드 · 명령
$ curl -LsSf https://astral.sh/uv/install.sh | sh

또는 wget을 사용합니다.

코드 · 명령
$ wget -qO- https://astral.sh/uv/install.sh | sh

Windows에서는 PowerShell을 사용합니다.

코드 · 명령
PS> powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

URL에 버전 번호(예: 0.11.24)를 포함하도록 수정하면 특정 버전을 지정하여 설치할 수 있습니다.

PyPI

pip 또는 pipx로 설치합니다.

코드 · 명령
$ pipx install uv

또는 pip로 설치합니다.

코드 · 명령
$ pip install uv

Homebrew

macOS 사용자의 경우:

코드 · 명령
$ brew install uv

MacPorts

코드 · 명령
$ sudo port install uv

WinGet

Windows에서:

코드 · 명령
$ winget install --id=astral-sh.uv  -e

Scoop

코드 · 명령
$ scoop install main/uv

Docker

uv는 ghcr.io/astral-sh/uv에서 컨테이너 이미지로도 제공됩니다.

GitHub Releases

GitHub Releases 페이지에서 바이너리를 직접 다운로드할 수 있습니다.

Cargo

Rust 사용자의 경우:

코드 · 명령
$ cargo install --locked uv

uv 업그레이드

단독 설치 프로그램으로 설치한 경우 자체 업데이트 기능을 사용할 수 있습니다.

코드 · 명령
$ uv self update

다른 설치 방법을 사용한 경우 해당 패키지 관리자의 업그레이드 명령을 사용합니다. pip의 경우:

코드 · 명령
$ pip install --upgrade uv

쉘 자동완성

쉘 설정 파일에 적절한 명령을 추가하여 자동완성을 활성화합니다.

Bash의 경우:

코드 · 명령
echo 'eval "$(uv generate-shell-completion bash)"' >> ~/.bashrc

Zsh의 경우:

코드 · 명령
echo 'eval "$(uv generate-shell-completion zsh)"' >> ~/.zshrc

Fish의 경우:

코드 · 명령
echo 'uv generate-shell-completion fish | source' > ~/.config/fish/completions/uv.fish

Elvish의 경우:

코드 · 명령
echo 'eval (uv generate-shell-completion elvish | slurp)' >> ~/.elvish/rc.elv

PowerShell의 경우:

코드 · 명령
if (!(Test-Path -Path $PROFILE)) {
  New-Item -ItemType File -Path $PROFILE -Force
}
Add-Content -Path $PROFILE -Value '(& uv generate-shell-completion powershell) | Out-String | Invoke-Expression'

제거

uv를 제거하려면 먼저 저장된 데이터를 정리합니다.

코드 · 명령
$ uv cache clean
$ rm -r "$(uv python dir)"
$ rm -r "$(uv tool dir)"

그런 다음 바이너리를 제거합니다. macOS 및 Linux에서:

코드 · 명령
$ rm ~/.local/bin/uv ~/.local/bin/uvx

Windows에서:

코드 · 명령
PS> rm $HOME\.local\bin\uv.exe
PS> rm $HOME\.local\bin\uvx.exe
PS> rm $HOME\.local\bin\uvw.exe

다음 단계

첫 번째 단계 가이드로 이동하거나 가이드 섹션을 탐색하여 uv를 시작하세요.

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

원문(영어): https://docs.astral.sh/uv/getting-started/installation/