uv 0.13.6 업그레이드: 워크스페이스 메모리와 디렉터리 삭제 버그 점검

uv 0.13.6의 디렉터리 삭제 버그 수정과 메모리 개선을 기준으로 업그레이드 우선순위를 정하고 CI·개발 환경의 Python 버전과 변형을 점검한다.

2026-11-10

--active --script를 쓰는 작업부터 업그레이드 대상을 찾는다

uv run --active --script와 uv sync --active --script가 가상환경이 아닌 디렉터리를 삭제하던 문제가 수정됐다. 이 조합을 사용하는 작업이 있다면, 메모리나 출력 속도를 비교하기 전에 수정 버전의 적용 여부부터 확인할 이유가 있다.

이 글의 기준은 **uv 0.13.6 (2026-10-26)**이다. 공식 릴리스노트는 해당 삭제 버그 수정과 함께 대형 워크스페이스의 메모리 개선, CPython 패치 버전 추가를 명시한다.

먼저 CI 설정과 개발용 스크립트에서 다음 명령 조합을 사용하는 지점을 찾는다. 아래는 점검할 명령 형태이며, 버그를 재현하려고 실행할 명령이 아니다.

uv run --active --script
uv sync --active --script

찾아낸 작업에서는 실제로 사용하는 uv 버전을 확인하고, 해당 조합이 실행되는 환경에 수정 버전이 적용되도록 한다. 로컬 도구만 바꾸고 CI의 실행 환경을 확인하지 않으면, 정작 점검 대상 작업에 수정이 반영됐는지 판단할 수 없다.

수정의 범위도 좁혀 읽어야 한다. 릴리스노트가 밝힌 내용은 이 명령 조합에서 비가상환경 디렉터리 삭제를 방지한다는 것이다. 삭제가 발생하던 구체적인 경로 조건이나 내부 판별 방식은 제공된 자료에 없다. 따라서 특정 디렉터리 구조라면 이전 버전도 괜찮다고 추정해서는 안 된다.

아래 비교는 이 수정의 적용 대상을 명령 조합과 디렉터리 종류의 관계로 구분한다.

⤢✕ 비가상환경 디렉터리 삭제 버그의 수정 범위 공통 적용 대상 uv run --active --script uv sync --active --script 변경 전 가상환경이 아닌 디렉터리가 삭제되던 버그 uv 0.13.6 가상환경이 아닌 디렉터리 삭제 방지 비교의 경계 구체적인 경로 조건과 내부 판별 방식은 제공된 자료에 없음

메모리 개선은 resolve와 lock·upgrade를 나눠 확인한다

모노레포에서 이번 릴리스를 평가할 때는 전체 작업 시간만 보지 말고 피크 메모리를 별도로 기록한다. 릴리스노트에는 대형 워크스페이스를 resolve할 때의 피크 메모리 감소와, 대형 프로젝트를 lock하거나 upgrade할 때의 피크 메모리 감소가 각각 적혀 있다.

실무에서는 평소 사용하는 큰 워크스페이스를 비교 대상으로 삼고, 변경 전후의 입력과 실행 조건을 가능한 한 맞추는 편이 낫다. uv 버전과 의존성 변경을 동시에 섞으면 관찰한 차이가 어디서 왔는지 구분하기 어렵다. 기존에 사용하는 메모리 측정 방법으로 각 작업의 최고 사용량을 남겨 두면, 이번 변경이 자신의 프로젝트에도 도움이 되는지 판단할 수 있다.

릴리스노트에는 절감 비율이나 벤치마크 조건이 없다. 메모리 부족으로 실패하던 작업이 반드시 성공한다거나, 실행 시간을 얼마나 줄인다고 약속할 근거도 없다. 업그레이드 판단에 쓸 결과는 프로젝트에서 직접 얻어야 한다.

출력 성능은 다른 조건을 봐야 한다. uv export와 uv pip compile은 출력을 리다이렉트할 때 속도가 개선됐다. 터미널에 출력하는 실행만 비교하면 릴리스노트가 지목한 조건을 확인하지 못한다.

작업 릴리스노트에 명시된 개선 적용 후 확인할 항목
대형 워크스페이스 resolve 피크 메모리 감소 같은 워크스페이스의 최고 메모리 사용량
대형 프로젝트 lock·upgrade 피크 메모리 감소 각 작업의 최고 메모리 사용량
uv export 출력 리다이렉트 출력 속도 개선 기존 리다이렉트 작업의 소요 시간
uv pip compile 출력 리다이렉트 출력 속도 개선 기존 리다이렉트 작업의 소요 시간

아래 도식은 개선을 검증할 때 작업별로 어느 측정 항목에 연결해야 하는지 보여 준다.

⤢✕대형 워크스페이스 resolve최고 메모리 사용량대형 프로젝트 lock·upgradeuv export 출력 리다이렉트소요 시간uv pip compile 출력리다이렉트변경 전후 비교

CPython 패치 버전과 Python 변형을 함께 관리한다

uv 0.13.6에는 CPython 3.11.18, 3.12.16, 3.13.18, 3.14.10, 3.15.2가 추가됐다. 이 목록은 CI와 개발 환경에서 현재 사용하는 버전 계열에 맞춰 검토할 대상이다.

uv 자체의 업데이트와 프로젝트 Python 버전의 변경은 적용 항목을 구분해서 기록한다. 릴리스노트의 “추가”만으로 기존 환경의 Python이 자동으로 바뀌었다고 판단할 수는 없다. CI 설정과 개발 환경이 실제로 어느 버전을 사용하는지 확인한 뒤, 패치 버전을 반영할 범위를 정한다.

현재 사용하는 CPython 계열 이번에 추가된 패치 버전 적용 검토 대상
3.11 3.11.18 해당 계열의 CI·개발 환경
3.12 3.12.16 해당 계열의 CI·개발 환경
3.13 3.13.18 해당 계열의 CI·개발 환경
3.14 3.14.10 해당 계열의 CI·개발 환경
3.15 3.15.2 해당 계열의 CI·개발 환경

제공된 자료에는 각 CPython 패치 버전의 수정 내용이 없다. 특정 보안 문제나 성능 개선을 이유로 이 버전들을 권할 수는 없다. 여기서 결정할 수 있는 것은 추가된 버전 중 무엇을 프로젝트의 검증 대상으로 삼을지다.

Python 버전 외에 변형도 확인해야 한다. 이번 릴리스는 uv python upgrade에서 free-threaded를 비롯한 비기본 변형을 보존하도록 수정했다.

uv python upgrade

이 명령을 사용하는 작업이라면 업그레이드 전의 버전과 변형을 기록하고, 실행 후에도 의도한 변형이 유지되는지 확인한다. 특히 비기본 변형을 쓰는 환경에서는 버전 번호만 확인하는 것으로 검증을 끝내지 않는다.

아래 도식은 Python 업데이트 검증에서 버전과 변형을 별도의 확인 축으로 둔다.

⤢✕ Python 업데이트 검증의 확인 축 검토 대상 × 변경 전 확인 × 변경 후 확인 검토 대상 변경 전 확인 변경 후 확인 버전 확인 CPython 패치 버전 CI·개발 환경의 현재 버전 계열 선택한 패치 버전의 실제 사용 여부 변형 확인 비기본 Python 변형 free-threaded 등 사용 중인 변형 uv python upgrade 이후 변형 유지 여부 uv 0.13.6 업그레이드: 워크스페이스 메모리와 디렉터리 삭제 버그 점검 | dev-env

Windows 대상 해석과 스크립트 환경 재사용은 해당 작업에서 검증한다

x86-64 Windows를 대상으로 의존성을 해석할 때 platform_machine에 AMD64를 사용하도록 수정됐다. 해당 플랫폼을 대상으로 하는 작업이 있다면, uv 업데이트 후 그 대상의 의존성 해석을 다시 수행하고 결과를 검토한다.

여기서 확인할 값은 아키텍처를 부르는 일반적인 이름이 아니라 릴리스노트가 명시한 platform_machine의 AMD64다. 다만 어떤 프로젝트의 어떤 의존성이 영향을 받는지는 자료에 없다. 모든 Windows 프로젝트의 결과가 바뀐다고 전제하지 말고, 해당 대상을 실제로 해석하는 작업에서 확인한다.

PEP 723 스크립트에는 별도의 성능 변경이 있다. 의존성이 없는 PEP 723 스크립트를 실행할 때 캐시된 환경이나 활성 환경을 재사용하도록 바뀌었다. 이런 스크립트를 반복 실행하는 개발 도구나 CI 작업이 있다면 실제 작업을 대상으로 실행 결과와 소요 시간을 비교할 수 있다.

이 변경과 앞서 다룬 삭제 버그 수정은 검증 목적이 다르다. 환경 재사용은 의존성 없는 PEP 723 스크립트의 성능 항목이고, 삭제 방지는 --active --script 조합의 버그 수정이다. 환경을 재사용한다는 설명만으로 디렉터리 삭제 문제의 발생 원인까지 설명해서는 안 된다.

주변 설정과 preview 출력은 사용하는 곳에서만 반영한다

환경변수나 초기화 작업을 자동화했다면 다음 변경도 적용 대상을 찾는 데 쓸 수 있다.

사용 조건 uv 0.13.6의 변경 점검할 내용
빈 UV_RUN_RECURSION_DEPTH 빈 값을 0으로 수용 빈 값을 전달하는 작업의 실행 결과
잘못된 UV_RUN_RECURSION_DEPTH 잘못된 값의 보고를 일관되게 처리 오류를 처리하는 자동화의 동작
[project] 없는 pyproject.toml에서 uv init 실행 프로젝트 메타데이터 추가 방법 안내 초기화 시 제공되는 안내
UV_INIT_BUILD_BACKEND 설정 상태에서 초기화 uv init --no-package와 uv init --script 허용 해당 환경변수를 쓰는 초기화 작업

preview 기능을 사용하는 경우에는 출력 소비 지점을 따로 확인한다. uv workspace metadata는 각 모듈의 owners를 객체 안에 중첩하도록 출력이 변경됐다. 이 출력을 읽는 자동화가 있다면 기존 필드 접근이 여전히 맞는지 검토한다. 제공된 자료에는 전체 출력 예시가 없으므로 새 스키마를 추정해 파서를 고치기보다 실제 출력을 확인해야 한다.

wheel-variants에서는 호환 휠 변형을 선택할 때 NVIDIA GPU 기능을 감지하고, 호환되지 않는 휠 변형이 요구하는 미지원 속성을 보고하도록 바뀌었다. 이 기능을 사용하는 환경에서는 선택 결과와 비호환 진단을 검증 대상으로 삼는다. preview 기능을 쓰지 않는 프로젝트라면 이번 업그레이드 검증을 위해 새로 활성화할 필요는 없다.

적용 완료는 각 작업의 결과로 판단한다

업그레이드 기록에는 uv 버전뿐 아니라 무엇을 확인했는지도 남긴다. --active --script 사용 지점에는 수정 버전이 적용됐는지, 큰 워크스페이스에서는 피크 메모리가 어떻게 달라졌는지, Python을 갱신했다면 선택한 패치 버전과 변형이 실제 환경에 반영됐는지를 기록한다.

성능 측정값이 기대만큼 달라지지 않더라도 릴리스노트의 수치를 재현하지 못했다고 볼 수는 없다. 공개된 감소율 자체가 없기 때문이다. 반대로 명령이 성공했다는 사실만으로 메모리 개선까지 검증한 것도 아니다. 삭제 버그 수정의 적용 여부, 성능 측정, Python 환경 확인을 각각의 증거로 남겨야 이번 업데이트가 프로젝트에 무엇을 바꿨는지 설명할 수 있다.

uvPython모노레포CI개발환경