대상 사용자: 프로그래머. Python 스크립트를 격리된 실행 환경에서 돌리고 프로젝트 의존성을 관리하려는 분을 위한 안내입니다. 첨부에는 제작사의 Windows x64 공식 ZIP 원본과 한국어 설명서·실습 ZIP이 있습니다. ARM64·32비트 Windows 사용자는 공식 릴리스에서 자신의 플랫폼 파일을 선택하세요.
1. 설치와 원본 확인
- 이 게시물의
uv-x86_64-pc-windows-msvc.zip을 받고, 필요하면 제작사 릴리스 페이지의 Windows x64 항목과 비교하세요. 공식 SHA-256은75d05de6762778c31ee183398de7dd15093fad0ed90b1f236d8205ea5ec00c90입니다. PowerShell에서Get-FileHash .\uv-x86_64-pc-windows-msvc.zip -Algorithm SHA256으로 확인합니다. - ZIP을 원하는 폴더에 완전히 압축 해제합니다.
uv.exe,uvx.exe,uvw.exe가 나옵니다. 현재 폴더에서./uv.exe --version을 실행해uv 0.12.23이 표시되는지 확인합니다. PowerShell에서는./대신.\uv.exe형식도 사용할 수 있습니다. - 매번 경로를 지정하기 번거로우면 해당 폴더를 사용자
PATH에 추가하고 새 터미널을 엽니다. 실행 파일을 옮길 때에는 ZIP 원본과 라이선스 고지문을 함께 보관하세요.
이 원본 ZIP은 제작사 배포 바이트를 바꾸지 않고 첨부했습니다. 원본 ZIP에는 실행 파일만 있어, 별도 실습 ZIP의 licenses/에 제작사 버전의 LICENSE-MIT, LICENSE-APACHE와 배포 출처·해시를 함께 넣었습니다. uv는 MIT 또는 Apache-2.0 조건 중 하나로 사용할 수 있습니다. 실습 자료의 자체 제작 부분은 CC0-1.0이며 uv의 라이선스를 변경하지 않습니다.
2. 실습: 스크립트 실행
실습 ZIP을 압축 해제한 뒤, Python 3.12가 이미 설치된 PowerShell에서 다음을 실행합니다. 아래 첫 경로는 uv.exe를 압축 해제한 폴더에 맞춰 바꾸세요. --offline은 새 다운로드를 막으며, --no-project는 주변 프로젝트 설정의 영향을 피합니다.
& 'C:\Tools\uv\uv.exe' --version
& 'C:\Tools\uv\uv.exe' run --no-project --offline --python 3.12 .\practice\hello.py
예상 출력은 rows=3 total=60입니다. 실습 파일은 표준 라이브러리로 CSV 세 줄을 읽고 숫자를 합산합니다. Python 3.12가 없다면 공식 설치 안내에 따라 uv 설치 후 uv python install 3.12로 관리형 Python을 받을 수 있습니다. 이 경우 네트워크와 저장 공간이 필요하며, 다운로드 뒤 실습 명령을 다시 실행하세요. 기존 업무 프로젝트 폴더 대신 이 실습 폴더에서 시작합니다.
| 파일 | 용도 |
|---|---|
practice/hello.py |
CSV 합계 출력 스크립트 |
practice/sample.csv |
세 행의 입력 데이터 |
README-KO.md, README-KO.html |
한국어 설치·사용·문제 해결 안내 |
licenses/ |
uv 원본 라이선스와 출처 고지 |
3. 문제 해결
uv.exe를 찾을 수 없음: 압축 해제 위치와 명령의 절대 경로를 확인하거나, 그 폴더에서.\uv.exe --version을 실행합니다. 새로 추가한PATH는 터미널을 다시 열어야 반영됩니다.- Python 3.12를 찾을 수 없음:
python --version과uv python list --only-installed를 확인합니다. 필요하면uv python install 3.12로 설치한 다음 재시도합니다. - 오프라인 실행에서 의존성 오류: 실습 스크립트는 외부 패키지를 쓰지 않습니다. 주변 프로젝트 설정이 섞이지 않도록
--no-project와 실습 폴더의 상대 경로를 확인합니다. 다른 프로젝트의 패키지 설치에는 네트워크가 필요할 수 있습니다. - 실행 정책 또는 보안 경고: 이 안내는 설치 스크립트를 실행하지 않고 공식 ZIP을 직접 풀어 사용합니다. 파일의 제작사 출처와 SHA-256을 확인한 뒤 조직 정책에 따라 처리하세요.
공식 근거: uv 0.12.23 릴리스와 체크섬, uv 설치 안내, 스크립트 실행 안내, CLI uv run, uv 라이선스.