$ sudo teach IT
Модуль 2 · Свой проект · Урок 2.3

Файл uv.lock

Поймёте, зачем нужен uv.lock, и поднимете проект на другом компьютере.

Теория + практика~5 минутНовичок

Файл uv.lock uv создал при первом запуске и обновляет при каждом uv add. Давайте заглянем, что в нём.

Точные версии для всех

В pyproject.toml записано «pyfiglet>=1.0.4» — эта версия или новее. Это как рецепт: «мука». А в uv.lock (lock-файл) записано, какая именно мука: точные версии всех пакетов проекта.

TOML · uv.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 имя.

Дальше — пакеты, которые нужны только вам, а не пользователям программы: например, для тестов.

На следующий урок