CPN 한국어 자습서 · 외부 문서 한국어 미러
UV 문서 · Guides
Installing and managing Python · 원문: docs.astral.sh/uv/guides/install-python/
아래는 원문을 한국어로 옮긴 미러입니다. 코드·명령은 원문 그대로이며, 가장 최신 정보는 하단 원문 링크에서 확인하세요.
시스템에 Python이 이미 설치되어 있으면 uv는 별도 설정 없이 이를 감지하고 사용합니다. 그러나 uv는 Python 버전을 직접 설치하고 관리할 수도 있습니다. uv는 필요한 Python 버전이 없으면 자동으로 설치합니다 — 시작하기 위해 Python을 미리 설치하지 않아도 됩니다.
최신 Python 버전을 설치하려면:
$ uv python install
참고: Python은 공식 배포 가능한 바이너리를 제공하지 않습니다. 따라서 uv는 Astral
python-build-standalone프로젝트의 배포본을 사용합니다. 자세한 내용은 Python 배포 문서를 참조하세요.
Python을 설치하면 uv 명령에서 자동으로 사용됩니다. uv는 설치된 버전을 PATH에도 추가합니다:
$ python3.13
uv는 기본적으로 버전이 명시된 실행 파일만 설치합니다. python 및 python3 실행 파일을 설치하려면 실험적인 --default 옵션을 사용하세요:
$ uv python install --default
특정 Python 버전을 설치하려면:
$ uv python install 3.12
여러 Python 버전을 설치하려면:
$ uv python install 3.11 3.12
PyPy 등 대체 Python 구현을 설치하려면:
$ uv python install pypy@latest
uv로 관리되는 Python 버전을 재설치하려면 --reinstall을 사용하세요:
$ uv python install --reinstall
이 명령은 이전에 설치된 모든 Python 버전을 재설치합니다. Python 배포본에 지속적으로 개선 사항이 추가되므로, Python 버전이 변경되지 않더라도 재설치하면 버그가 해결될 수 있습니다.
사용 가능하고 설치된 Python 버전을 보려면:
$ uv python list
uv를 사용하기 위해 Python을 명시적으로 설치하지 않아도 됩니다. 기본적으로 uv는 필요할 때 Python 버전을 자동으로 다운로드합니다. 예를 들어, Python 3.12가 설치되어 있지 않으면 다음 명령이 이를 다운로드합니다:
$ uvx ruff@latest -c "print('hello world')"
특정 Python 버전을 요청하지 않아도 uv는 필요 시 최신 버전을 다운로드합니다. 예를 들어, 시스템에 Python 버전이 없는 경우 다음 명령은 새 가상환경(virtual environment)을 만들기 전에 Python을 설치합니다:
$ uv venv
uv는 시스템에 기존 Python 설치가 있으면 이를 사용합니다. 이 동작에는 별도 설정이 필요하지 않습니다. 명령 실행 요구 사항을 만족하면 uv는 시스템 Python을 사용합니다. 자세한 내용은 Python 검색 문서를 참조하세요.
uv가 시스템 Python을 사용하도록 강제하려면 --no-managed-python 플래그를 사용하세요. 자세한 내용은 Python 버전 선호도 문서를 참조하세요.
중요: Python 패치 버전 업그레이드 지원은 프리뷰 상태입니다. 동작이 실험적이므로 변경될 수 있습니다.
Python 버전을 최신 지원 패치 릴리스로 업그레이드하려면:
$ uv python upgrade 3.12
uv로 관리되는 모든 Python 버전을 업그레이드하려면:
$ uv python upgrade
uv python에 대해 더 알아보려면 Python 버전 개념 페이지와 명령 참조를 확인하세요.
또는 계속 읽어 uv로 스크립트를 실행하고 Python을 호출하는 방법을 알아보세요.
원문(영어): https://docs.astral.sh/uv/guides/install-python/ · 본 문서는 학습용 한국어 번역이며 원본의 권리는 원저작자(Astral)에게 있습니다.