CPN 한국어 자습서 · 외부 문서 한국어 미러
UV 문서 · Reference
Storage · 원문: docs.astral.sh/uv/reference/storage/
아래는 원문을 한국어로 옮긴 미러입니다. 코드·명령은 원문 그대로이며, 가장 최신 정보는 하단 원문 링크에서 확인하세요.
uv는 플랫폼별 여러 디렉터리에 파일을 구성합니다. 도구는 정해진 순서로 환경 변수를 확인하고 처음 발견된 경로를 사용합니다.
일시적인 데이터에 사용합니다.
Unix:
1. $TMPDIR
2. /tmp
Windows:
1. %TMP%
2. %TEMP%
3. %USERPROFILE%
지속성으로 이득을 볼 수 있는 임시 데이터를 저장합니다.
Unix:
1. $XDG_CACHE_HOME/uv
2. $HOME/.cache/uv
Windows:
1. %LOCALAPPDATA%\uv\cache
2. FOLDERID_LocalAppData 내 uv\cache
임시적이지 않은 데이터를 보관합니다.
Unix:
1. $XDG_DATA_HOME/uv
2. $HOME/.local/share/uv
3. $CWD/.uv
Windows:
1. %APPDATA%\uv\data
2. .\.uv
사용자 수준 구성:
Unix:
1. $XDG_CONFIG_HOME/uv
2. $HOME/.config/uv
Windows:
1. %APPDATA%\uv
2. FOLDERID_RoamingAppData 내 uv
시스템 수준 구성:
Unix:
1. $XDG_CONFIG_DIRS/uv
2. /etc/uv
Windows:
1. %PROGRAMDATA%\uv
2. FOLDERID_AppDataProgramData 내 uv
사용자의 PATH에 있는 실행 가능한 파일을 저장합니다.
Unix:
1. $XDG_BIN_HOME
2. $XDG_DATA_HOME/../bin
3. $HOME/.local/bin
Windows:
1. %XDG_BIN_HOME%
2. %XDG_DATA_HOME%\..\bin
3. %USERPROFILE%\.local\bin
uv는 의존성 재다운로드 및 재빌드를 방지하기 위해 로컬 캐시를 유지합니다. 캐시 위치는 기본적으로 캐시 디렉터리이지만, 명령줄 인수, 환경 변수 또는 설정으로 재정의할 수 있습니다. uv cache dir 명령으로 현재 캐시 디렉터리를 표시합니다.
참고: "최적의 성능을 위해 캐시 디렉터리는 가상환경과 동일한 파일 시스템에 있어야 합니다."
관리형 Python 버전은 uv python install과 같은 명령으로 설치합니다. 기본적으로 영구 데이터 디렉터리의 python/ 하위 디렉터리(예: ~/.local/share/uv/python)에 저장됩니다. uv python dir 명령으로 위치를 조회하거나 UV_PYTHON_INSTALL_DIR로 재정의합니다.
Python 버전의 실행 파일(예: python3.13)은 기본적으로 실행 파일 디렉터리에 저장됩니다. uv python dir --bin으로 위치를 확인하거나 UV_PYTHON_BIN_DIR로 재정의합니다.
uv tool install로 설치된 명령줄 도구는 기본적으로 영구 데이터 디렉터리의 tools/ 하위 디렉터리로 이동합니다. uv tool dir 명령으로 위치를 표시하거나 UV_TOOL_DIR로 사용자 정의합니다.
설치된 도구의 실행 파일(예: ruff)은 기본적으로 실행 파일 디렉터리에 저장됩니다. uv tool dir --bin으로 확인하거나 UV_TOOL_BIN_DIR로 재구성합니다.
독립 실행형 설치 프로그램은 uv와 uvx 실행 파일을 실행 파일 디렉터리에 배치합니다. UV_INSTALL_DIR로 구성합니다.
uv는 구성 디렉터리에서 TOML 구성 파일을 읽어 동작을 사용자 정의합니다.
프로젝트는 전용 가상환경(virtual environment)을 받습니다. 기본적으로 pyproject.toml 옆의 .venv에 생성됩니다. UV_PROJECT_ENVIRONMENT로 재정의합니다.
인라인 메타데이터가 있는 스크립트는 캐시 디렉터리에 생성된 전용 가상환경을 받습니다.
원문(영어): https://docs.astral.sh/uv/reference/storage/ · 본 문서는 학습용 한국어 번역이며 원본의 권리는 원저작자(Astral)에게 있습니다.