uv 로 python 버전 관리
uv 로 python 버전 관리
- pyenv 와 'Python Install Manager', 기존 설치된 python 는 삭제 권장
- 장점 : 리눅스와 윈도우에서 호환 명령으로 python 버전 관리
- uv 설치
- 윈도우
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
- 리눅스에서 설치
curl -LsSf https://astral.sh/uv/install.sh | sh
---------------------------------------
- Python Install Manager 는 삭제 권장
- 윈도우 설정
앱 -> 고급 앱 설정 -> 앱 실행 별칭
- python 관련 설정 : 끔
---------------------------------------
- uv 삭제
* Windows:
%USERPROFILE%\.local\bin\uv.exe (및 uvx.exe) 삭제
- %APPDATA%\uv 및 %LOCALAPPDATA%\uv 폴더 삭제
rmdir /s /q "%APPDATA%\uv"
rmdir /s /q "%LOCALAPPDATA%\uv"
* Linux / macOS:
Bashrm ~/.local/bin/uv ~/.local/bin/uvx
rm -rf ~/.local/share/uv ~/.cache/uv
---------------------------------------
- 자체 업데이트
uv self update
---------------------------------------
# 설치된/설치 가능한 파이썬 목록 조회
uv python list
# 특정 파이썬 버전 설치
uv python install 3.12
uv python install 3.11 3.12 3.13 # 여러 버전 한 번에 설치
- 설치 경로
%APPDATA%\uv\python\cpython-3.12.x-windows-x86_64-none\
- 기본 python 버전 변경하고 지정
uv python install 3.12 --default
uv python pin --global 3.12
# 설치된 모든 파이썬 버전을 최신 패치 버전으로 업데이트
uv python upgrade
# 특정 마이너 버전(예: 3.12)만 최신 패치로 업데이트
uv python upgrade 3.12
# 설치된 특정 파이썬 버전 삭제
uv python uninstall 3.11
---------------------------------------
# 현재 적용 중인 기본 파이썬 경로 확인
uv python find
# 전역 기본 python 버전 지정
uv python install 3.12 --default
uv python pin --global 3.12
# 현재 프로젝트 폴더의 파이썬 버전 고정 (.python-version 생성)
uv python pin 3.12
# 특정 버전을 기본값으로 적용하여 가상환경(.venv) 생성
uv venv --python 3.12
---------------------------------------
설정된 python 버전과 연동되는 pip 명령
// %USERPROFILE%\.local\bin\pip.cmd
@echo off
setlocal
set "PIP_BREAK_SYSTEM_PACKAGES=1"
python -m pip %*//
-------------------------------------------------------------------------------
uv로 python 버전 변경 명령
// %USERPROFILE%\.local\bin\ch_uv_py.cmd
@echo on
chcp 65001 > nul
setlocal
rem uv 로 python 버전 변경
echo 실행중이 python 종료 필요(vscode,.. 등)
if "%~1"=="" (
echo Usage: ch_uv_py VERSION
echo Example: ch_uv_py 3.12
exit /b 2
)
set "PYTHON_REQUEST=%~1"
for /f "tokens=1,2 delims=." %%A in ("%PYTHON_REQUEST%") do set "EXPECTED_VERSION=%%A.%%B"
uv python install "%PYTHON_REQUEST%" --default
if errorlevel 1 exit /b 1
for /f "delims=" %%V in ('python -c "import sys; print(f'{sys.version_info.major}.{sys.version_info.minor}')"') do set "ACTIVE_VERSION=%%V"
if not "%ACTIVE_VERSION%"=="%EXPECTED_VERSION%" (
uv python pin --global "%ACTIVE_VERSION%" >nul
echo.
echo ERROR: python.exe is still using Python %ACTIVE_VERSION%.
echo Close programs using C:\Users\userx\.local\bin\python.exe, then retry.
echo In this case, close or reload VS Code because Black Formatter is using it.
exit /b 1
)
uv python pin --global "%PYTHON_REQUEST%"
if errorlevel 1 exit /b 1
python -m pip --version >nul 2>&1
if errorlevel 1 (
set "PIP_BREAK_SYSTEM_PACKAGES=1"
python -m ensurepip --upgrade
if errorlevel 1 exit /b 1
)
echo.
echo Active Python:
python --version
python -c "import sys; print(sys.executable)"
call pip --version//
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
Python Install Manager 로 python 설치 (주의! 사용 비추천!)
- 주의! uv 가 더 권장됨
- 기존 Python Launcher 는 지원 중단 예정
- Python Install Manager 설치후 환경 설정 점검
py install --configure
- 윈도우 설정
앱 -> 고급 앱 설정 -> 앱 실행 별칭
- python 관련 설정 : 켬
- 기본 명령
설치 가능 버전 확인 : py list --online
내 PC에 설치된 버전 목록 : py --list (또나 py -0)
특정 파이썬 버전 설치 : py install 3.14 (버전 명시)
파이썬 버전 업데이트 : py install --upgrade 3.14
특정 버전 삭제 (삭제) : py uninstall 3.14
모든 파이썬 및 설정 완전 제거 : py uninstall --purge
- 설치 경로
%LocalAppData%\Python\
---------------------------------------
* Python Install Manager 삭제
- (uv로 대체할 경우)
- 설치된 python 삭제
py uninstall --purge
- Python Install Manager 삭제
윈도우 설정 -> 앱 -> 설치된 앱 : 앱 선택해서 삭제
앱 -> 고급 앱 설정 -> 앱 실행 별칭
- python 관련 설정 : 끔