Вы уже умеете почти всё, что нужно для работы с uv. Осталось собрать это в одно место и посмотреть, на чём чаще всего спотыкаются.
Частые ошибки
Четыре ошибки, которые встречаются чаще всего. У каждой своя причина и своё простое лекарство.
$ uv add pyfigleterror: 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. Поздравляем!