Python UV 사용법

• 회사에서 uv python install 잘 안될 때 사용 중인 네트워크(예: 회사 네트워크)가 Zscaler, Cisco Umbrella 같은 프록시를 통해 SSL 검사를 수행하고 있을 가능성이 높습니다. 이 경우, 프록시가 중간에 자체 인증서를 삽입하여 uv가 사용하는 기본 인증서 저장소(Mozilla의 webpki-roots)에서 이를 신뢰하지 못해 UnknownIssuer 에러가 발생합니다.

• 설치된 python 버전 보는 방법 uv python list

• 설치방법 시스템 신뢰 저장소 사용 (–native-tls 옵션) uv가 시스템의 신뢰 저장소(Windows 인증서 저장소)를 사용하도록 설정하면, 기업 CA 인증서를 신뢰할 가능성이 높아집니다. uv python install cpython-3.13.3+freethreaded-windows-x86_64-none --native-tls

• 지우는 방법 uv python uninstall cpython-3.13.3+freethreaded-windows-x86_64-none

• 현재 프로젝트의 가상 환경 경로를 표시 uv venv --show-settings

• system에 global로 설치된 패키지 확인하기 uv pip list

• system에 global로 패키지 설치 uv pip install requests --system

• 기본 system python 버전 설정 $env:UV_PYTHON="3.13.3"

• system python 버전 확인 uv pip list --system

• python 버전 선택하여 프로젝트 실행하기 uv run --python 3.13.3 python --version

• 프로젝트의 기본 python 버전 변경

  1. 삭제 후 다시 설정
     기존 .venv 삭제하고
     uv venv --python 3.13.3

  2. .python-version 사용하기
     .python-version 파일을 사용한다.
     echo "3.13.3" > .python-version

  3. pyproject.toml을 편집 (requires-python = “>=3.13.3”: 프로젝트가 Python 3.13.3 이상을 요구하도록 설정.)
     [project]
     name = "testVenv"
     version = "0.1.0"
     requires-python = ">=3.13.3"
     dependencies = []

  4. 확인 방법
     uv python find

• 설치 후 최전 버전 update uv self update

초기화 uv init example

의존성 추가 uv add ruff uv add ruff=2.2.2 uv remove ruff uv add ruff --dev

uv export -o requirements.txt uv export -o requiremenets.txt

uv run hello.py

인증서 문제

uv --native-tls venv