CPN 한국어 자습서 · 외부 문서 한국어 미러
UV 문서 · Reference
Environment variables · 원문: docs.astral.sh/uv/reference/environment/
아래는 원문을 한국어로 옮긴 미러입니다. 코드·명령은 원문 그대로이며, 가장 최신 정보는 하단 원문 링크에서 확인하세요.
uv는 동작 구성 및 제어를 위한 포괄적인 환경 변수 집합을 정의하고 준수합니다.
UV_CACHE_DIR - 기본 캐시 위치 대신 uv가 캐시된 데이터를 저장하는 경로를 지정합니다.
UV_CONFIG_FILE - 프로젝트 설정을 위한 사용자 정의 uv.toml 구성 파일을 지정합니다.
UV_NO_CONFIG - 설정하면 uv가 현재 디렉터리 및 부모 디렉터리의 모든 구성 파일을 무시합니다.
UV_CONSTRAINT - 허용 가능한 패키지 버전을 제한하는 제약 파일(공백으로 구분)을 지정합니다.
UV_OVERRIDE - 특정 의존성 버전을 강제하기 위한 재정의 파일(공백으로 구분)을 지정합니다.
UV_EXCLUDE_NEWER - 지정된 날짜 이후에 게시된 패키지를 제외합니다. 이 필터링을 비활성화하려면 false로 설정합니다.
UV_PRERELEASE - 사전 릴리스 버전 허용 여부를 제어합니다(예: allow는 모든 의존성에서 허용).
UV_RESOLUTION - 해결 전략을 설정합니다. 예: lowest-direct는 직접 의존성의 최소 호환 버전을 설치합니다.
UV_INDEX_URL - 더 이상 사용하지 않음(deprecated); 기본 패키지 인덱스 지정에는 UV_DEFAULT_INDEX를 사용하세요.
UV_DEFAULT_INDEX - 기본 패키지 인덱스 URL을 설정합니다.
UV_EXTRA_INDEX_URL - 추가 패키지 인덱스의 공백 구분 목록입니다(deprecated; UV_INDEX 사용 권장).
UV_INDEX - 패키지 검색을 위한 인덱스 URL의 공백 구분 목록입니다.
UV_INDEX_STRATEGY - 여러 인덱스를 조회하는 방법을 결정합니다. "unsafe-best-match"는 모든 인덱스에서 버전을 고려합니다.
UV_INDEX_{name}_USERNAME 및 UV_INDEX_{name}_PASSWORD - 명명된 인덱스에 대한 HTTP 기본 인증 자격증명을 제공합니다.
UV_PYTHON - 모든 uv 작업에 사용할 특정 Python 인터프리터 경로입니다.
UV_SYSTEM_PYTHON - true일 때 시스템 PATH에서 처음 발견된 Python을 사용합니다.
UV_MANAGED_PYTHON - uv가 관리하는 Python 버전을 필요로 합니다. UV_NO_MANAGED_PYTHON 설정 시 비활성화됩니다.
UV_PYTHON_PREFERENCE - 시스템 Python과 관리형 Python 설치 중 선호도를 나타냅니다.
UV_PYTHON_DOWNLOADS - uv가 Python 버전을 자동으로 다운로드할 수 있는지 제어합니다.
UV_PYTHON_INSTALL_DIR - 관리형 Python 설치를 저장하는 디렉터리입니다.
UV_PYTHON_CACHE_DIR - 설정 전 Python 설치 아카이브를 캐싱하는 디렉터리입니다.
UV_PYTHON_INSTALL_MIRROR - 관리형 Python 다운로드를 위한 미러 URL입니다(기본 Astral 레포지토리를 대체).
UV_PYTHON_CPYTHON_BUILD, UV_PYTHON_PYPY_BUILD, UV_PYTHON_GRAALPY_BUILD, UV_PYTHON_PYODIDE_BUILD - 각 Python 구현체의 특정 빌드 버전을 고정합니다.
UV_PYPY_INSTALL_MIRROR - PyPy 설치를 위한 미러 URL입니다(downloads.python.org를 대체).
UV_VENV_SEED - 생성된 가상환경(virtual environment)에 시드 패키지(pip, setuptools, wheel)를 설치합니다.
UV_VENV_CLEAR - 생성 전 대상 경로의 기존 파일/디렉터리를 제거합니다.
UV_VENV_RELOCATABLE - 설정하면 가상환경을 이식 가능하게 만듭니다.
UV_NO_BUILD - 소스 배포판 빌드를 방지합니다.
UV_NO_BUILD_ISOLATION - 소스 배포판 빌드 시 격리를 건너뜁니다.
UV_NO_BINARY - 모든 패키지를 소스에서 설치합니다(단, wheel은 해결을 위한 메타데이터 추출에 사용됨).
UV_NO_BINARY_PACKAGE - 사전 빌드된 wheel 사용에서 제외할 패키지(공백 구분)입니다.
UV_LINK_MODE - 패키지를 환경에 링크하는 방법을 지정합니다.
UV_COMPILE_BYTECODE - 설치 후 Python 소스 파일을 바이트코드로 컴파일합니다.
UV_COMPILE_BYTECODE_TIMEOUT - 바이트코드 컴파일의 타임아웃(초)입니다.
UV_HTTP_TIMEOUT - HTTP 읽기의 기본 타임아웃: 30초.
UV_HTTP_CONNECT_TIMEOUT - 서버 연결 타임아웃: 기본값 10초.
UV_HTTP_RETRIES - HTTP 요청 재시도 횟수: 기본값 3.
UV_REQUEST_TIMEOUT - UV_HTTP_TIMEOUT과 동일합니다.
UV_UPLOAD_HTTP_TIMEOUT - 업로드 요청 타임아웃: 기본값 900초.
UV_OFFLINE - 설정하면 모든 네트워크 접근을 비활성화합니다.
UV_PUBLISH_URL - uv publish의 패키지 인덱스 업로드 엔드포인트입니다.
UV_PUBLISH_TOKEN, UV_PUBLISH_USERNAME, UV_PUBLISH_PASSWORD - 패키지 게시를 위한 인증 자격증명입니다.
UV_PUBLISH_INDEX - 게시에 사용할 구성된 인덱스를 지정합니다.
UV_TOOL_DIR - uv가 관리형 도구를 저장하는 디렉터리입니다.
UV_TOOL_BIN_DIR - 도구 실행 파일을 설치하는 디렉터리입니다.
UV_CONCURRENT_BUILDS - 동시 소스 배포판 빌드의 최대 수입니다.
UV_CONCURRENT_DOWNLOADS - 최대 동시 다운로드 수입니다.
UV_CONCURRENT_INSTALLS - 패키지 설치 및 압축 해제를 위한 스레드 수입니다.
UV_STACK_SIZE - 스택 크기(바이트); 설정하지 않으면 기본값 4MB입니다.
UV_PREVIEW - 프리뷰 모드를 활성화합니다.
UV_PREVIEW_FEATURES - 특정 프리뷰 기능을 활성화합니다.
UV_DEV / UV_NO_DEV - 개발 의존성을 포함하거나 제외합니다.
UV_FROZEN - uv.lock을 갱신하지 않고 실행합니다.
UV_LOCKED - uv.lock이 변경되지 않았음을 assert합니다.
uv는 다음과 같은 표준 환경 변수를 준수합니다:
PATH, HOME, PWD - 표준 POSIX 변수HTTP_PROXY, HTTPS_PROXY, ALL_PROXY, NO_PROXY - 프록시 구성SSL_CERT_FILE, SSL_CERT_DIR - TLS 인증서 경로VIRTUAL_ENV - 활성화된 가상환경 감지CONDA_PREFIX, CONDA_DEFAULT_ENV - Conda 환경 감지HF_TOKEN - Hugging Face 인증AWS_* 변수 - S3 엔드포인트 서명을 위한 AWS 자격증명 구성NETRC - 자격증명을 위한 .netrc 파일 위치BASH_VERSION, ZSH_VERSION, FISH_VERSION, KSH_VERSION, NU_VERSIONNO_COLOR, FORCE_COLOR, CLICOLOR_FORCE - 컬러 출력 제어RUST_LOG, RUST_BACKTRACE - 로깅 및 디버깅원문(영어): https://docs.astral.sh/uv/reference/environment/ · 본 문서는 학습용 한국어 번역이며 원본의 권리는 원저작자(Astral)에게 있습니다.