$ sudo teach IT
Модуль 3 · В работе · Урок 3.4

Шпаргалка uv

Вы соберёте все команды курса в одну таблицу, узнаете частые ошибки и выберете, куда идти дальше.

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

Вы уже умеете почти всё, что нужно для работы с uv. Осталось собрать это в одно место и посмотреть, на чём чаще всего спотыкаются.

Частые ошибки

Четыре ошибки, которые встречаются чаще всего. У каждой своя причина и своё простое лекарство.

Терминал
$ uv add pyfiglet
Вывод
error: No `pyproject.toml` found in current directory or any parent directory

Разбор по строкам

  • uv add pyfiglet — просим добавить пакет в проект.
  • No `pyproject.toml` found — uv искал файл проекта в текущей папке и выше, но не нашёл: вы не в папке проекта.

Что видно, почему и что делать

  • Ошибка выше. Вы не в проекте. Перейдите в папку проекта командой cd banner или создайте проект: uv init.
  • Поставили пакет через pip install. Он не записался в pyproject.toml, и у коллеги его не будет. Ставьте через uv add.
  • Правите uv.lock руками. Не надо: файл пишет сам uv. Меняйте зависимости через uv add или обновляйте командой uv lock.
  • Запускаете python main.py вместо uv run. Системный Python не знает про пакеты проекта и отвечает ModuleNotFoundError: No module named 'pyfiglet' (как в уроке 3.2). Запускайте через uv run.

Шпаргалка

КомандаКогда нужна
uv init bannerсоздать новый проект
uv run bannerзапустить программу проекта (или файл: uv run hi.py)
uv run --with pyfiglet hi.pyзапустить файл с пакетом на один раз, без проекта
uv add pyfigletдобавить пакет в проект
uv add --dev pytestдобавить пакет только для разработки
uv remove pyfigletубрать пакет из проекта
uv treeпоказать, какие пакеты стоят в проекте
uv syncсобрать .venv по uv.lock (после клонирования)
uv lock --upgrade-package pyfigletобновить один пакет в uv.lock
uv python install 3.14скачать нужную версию Python
uv python pin 3.14записать версию Python в .python-version
uvx ruff checkзапустить инструмент разово, не ставя его
uv venv и uv pip install -r requirements.txtстарый стиль: окружение и пакеты из requirements.txt
uv add -r requirements.txtперенести пакеты из requirements.txt в проект

Что вы уже умеете

  • Запускать Python-файлы через uv run, даже если нужного пакета или Python нет.
  • Создавать проект и вести его зависимости: uv init, uv add, uv remove.
  • Держать окружение в порядке: uv.lock, uv sync, версия Python проекта.
  • Запускать инструменты через uvx и переносить старые проекты на uv.

Попробуйте

  • Создайте новый проект с нуля по шпаргалке, не подглядывая в уроки: uv init, uv add любого пакета, uv run.
  • Если на каком-то шаге застряли, найдите нужную команду в таблице и вернитесь к проекту.

Что запомнить

  • Все команды uv начинаются с uv; в проекте их запускаем из его папки.
  • Пакеты добавляем через uv add, программу запускаем через uv run, uv.lock руками не правим.
  • Не знаете команду — смотрите в таблицу выше.

Куда дальше

Если вы знаете основы Python и хотите делать свои программы, ваш следующий шаг — курс Python PRO. В нём 5 модулей и 39 уроков. Там настоящие проекты: вы напишете Телеграм-бот, сайт на Django и сервис на FastAPI. Именно в таких проектах uv пригодится сразу. Завести проект (uv init), добавить пакеты (uv add) и запустить программу (uv run) вы уже умеете, а uv.lock позаботится, чтобы у всех версии пакетов совпадали. Так что к Python PRO вы придёте с готовой привычкой, а не с пустыми руками.

Если хочется остаться в теме инструментов, загляните в бесплатный курс Ruff для начинающих: сделали его те же авторы, что и uv, а Ruff вы уже запускали через uvx. А тесты подробно разбираются в курсе Pytest.

Вот и всё. Вы прошли курс и теперь умеете работать с uv. Поздравляем!