byteforce

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

UV 문서 · Reference

설치 프로그램 옵션

Installer options · 원문: docs.astral.sh/uv/reference/installer/

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

설치 경로 변경

기본적으로 uv는 사용자 실행 파일 디렉터리에 설치됩니다. 이 위치를 변경하려면 UV_INSTALL_DIR 환경 변수를 설정합니다:

macOS 및 Linux:

코드 · 명령
$ curl -LsSf https://astral.sh/uv/install.sh | env UV_INSTALL_DIR="/custom/path" sh

Windows:

코드 · 명령
PS> powershell -ExecutionPolicy ByPass -c {$env:UV_INSTALL_DIR = "C:\Custom\Path";irm https://astral.sh/uv/install.ps1 | iex}

참고: 설치 경로를 변경해도 uv 바이너리가 설치되는 위치만 영향을 받습니다. uv는 데이터(캐시, Python 설치, 도구 등)를 여전히 기본 위치에 저장합니다.

셸 수정 비활성화

설치 프로그램은 uv가 PATH에 포함되도록 셸 프로파일을 업데이트할 수 있습니다. 이를 방지하려면 UV_NO_MODIFY_PATH 변수를 사용합니다:

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

이 플래그로 설치하면 이후 uv self update와 같은 작업도 셸 프로파일 수정을 건너뜁니다.

비관리형 설치

CI 시스템과 같은 일시적 환경에서는 셸 프로파일이나 환경 변수를 수정하지 않고 특정 경로에 uv를 설치하기 위해 UV_UNMANAGED_INSTALL을 사용합니다:

코드 · 명령
$ curl -LsSf https://astral.sh/uv/install.sh | env UV_UNMANAGED_INSTALL="/custom/path" sh

이 플래그는 uv self update를 통한 자동 업데이트도 비활성화합니다.

설치 스크립트에 옵션 전달

크로스 플랫폼 일관성을 위해 환경 변수 사용을 권장하지만, 설치 스크립트에 직접 옵션을 전달할 수도 있습니다:

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

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

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