Файл uv.lock uv создал при первом запуске и обновляет при каждом uv add. Давайте заглянем, что в нём.
Точные версии для всех
В pyproject.toml записано «pyfiglet>=1.0.4» — эта версия или новее. Это как рецепт: «мука». А в uv.lock (lock-файл) записано, какая именно мука: точные версии всех пакетов проекта.
[[package]]
name = "pyfiglet"
version = "1.0.4"
source = { registry = "https://pypi.org/simple" }
Разбор по строкам
[[package]]— запись об одном пакете.version— точная версия, не «или новее».source— откуда скачан: с PyPI (склад пакетов).
Файл пишет сам uv, руками не правим. В git его кладём вместе с pyproject.toml и .python-version; .venv не кладём — она уже в .gitignore.
Проект на другом компьютере
Коллега скачивает проект из git. Папки .venv там нет, зато есть uv.lock. Одна команда — uv sync (синхронизация):
$ git clone <адрес репозитория>
$ cd banner
$ uv sync
Using CPython 3.15.2 interpreter at: ~/.local/bin/python3.15
Creating virtual environment at: .venv
Resolved 2 packages
Installed 2 packages
+ banner==0.1.0 (from file://~/banner)
+ pyfiglet==1.0.4
Разбор по строкам
uv sync— привести.venvкuv.lock.Creating virtual environment— окружения не было, uv создал его.+ pyfiglet==1.0.4— та самая версия из lock-файла, как у вас.
Всё. Можно сразу писать uv run banner — синхронизацию uv сделает сам.
Обновить пакет
Версии в uv.lock сами не меняются. Нужна свежая — попросите uv:
$ uv lock --upgrade-package pyfiglet
Resolved 2 packages
Версия этого пакета в uv.lock поднимется до новейшей подходящей. У нас уже последняя, поэтому ничего не изменилось.
Вы уже на полпути
Вы уже умеете то, без чего не обходится ни один проект. Дальше на Python строят ботов и сайты: в курсе Python PRO делают Телеграм-бота, Django-сайт и API на FastAPI. А мы пока продолжаем с uv.
Попробуйте
Удалите папку .venv (в проводнике; или rm -rf .venv в macOS/Linux, Remove-Item -Recurse -Force .venv в PowerShell) и снова запустите программу. uv соберёт окружение заново:
$ rm -rf .venv
$ uv run banner
Using CPython 3.15.2 interpreter at: ~/.local/bin/python3.15
Creating virtual environment at: .venv
Installed 2 packages
_ ___ __
| | | \ \ / /
| |_| |\ V /
\__,_| \_/
Что запомнить
pyproject.toml— что нужно,uv.lock— какие версии точно. Руками не правим.- В git:
pyproject.toml,uv.lock,.python-version;.venvнет. На другом компьютере —uv sync. - Обновить пакет:
uv lock --upgrade-package имя.
Дальше — пакеты, которые нужны только вам, а не пользователям программы: например, для тестов.