속보02 / IT
Python 3.15 전환 오류에 uv.lock 삭제 조언
uv 공식 문서는 잠금 파일을 버전 관리에 넣도록 안내하며, 삭제 처방은 개인 경험에서 나온 조언이다.

Simon Willison은 11월 1일 블로그에서 Python 3.15 전환 뒤 의존성 오류가 나면 uv.lock을 지운다고 썼다. 잠금 파일이 남은 프로젝트를 새 Python으로 옮기는 uv 사용자에게 해당된다.
Willison이 올린 오류 로그에는 빌드 실패가 남아 있다. 실패한 쪽은 Python 패키지 watchfiles 1.1.1로 기록됐다. 글에 따르면 파일을 지우고 uv run pytest를 다시 실행하면 대체로 해결된다.
호환성. uv 문서에 따르면 uv.lock이 있으면 uv sync와 uv lock은 잠긴 버전을 우선한다. PyPI 설명에 적힌 watchfiles 1.1.1의 지원 범위는 Python 3.9부터 3.14까지다. 3.15는 이 범위에서 벗어난다.
uv 문서는 잠금 파일을 두고 "This file should be checked into version control"라고 적었다. 재현 가능한 설치가 그 이유로 제시됐다. 패키지 갱신에는 uv lock --upgrade 명령이 제공된다.
Willison은 프로젝트 대부분이 라이브러리라 uv.lock을 두지 않는다고 설명했다. 라이브러리가 다른 사용처의 버전까지 잠그면 무례하다는 이유를 들었다. 다만 uv run pytest 같은 명령을 돌리면 이 파일이 자주 남는다고 썼다.
실행 환경. uv 저장소가 밝힌 라이선스는 Apache License 2.0과 MIT로 제시된다. 사용자가 둘 중 하나를 고르게 된다. 지원 운영체제는 macOS, Linux, Windows로 적혀 있다.
삭제 처방은 Willison의 경험에서 나온 조언으로 구분된다. 글에는 당시 쓴 uv 버전과 삭제 뒤 해결 비율이 나오지 않는다.