Возможности uv

uv предоставляет базовые возможности для разработки на Python — от установки Python и работы с простыми скриптами до крупных проектов с поддержкой нескольких версий Python и платформ.

Интерфейс uv можно разделить на разделы, которые можно использовать по отдельности или вместе.

Версии Python

Установка и управление самим Python.

uv python uninstall: Удалить версию Python.
uv python pin: Зафиксировать версию Python для текущего проекта.
uv python find: Найти установленную версию Python.
uv python list: Показать доступные версии Python.
uv python install: Установить версии Python.

Подробнее в руководстве по установке Python.

Скрипты

Запуск отдельных Python-скриптов, например example.py.

uv remove --script: Удалить зависимость из скрипта.
uv add --script: Добавить зависимость в скрипт.
uv run: Запустить скрипт.

Подробнее в руководстве по запуску скриптов.

Проекты

Создание и работа с Python-проектами, то есть с pyproject.toml.

uv publish: Опубликовать проект в реестре пакетов.
uv build: Собрать проект в архивы дистрибутивов.
uv tree: Показать дерево зависимостей проекта.
uv run: Выполнить команду в окружении проекта.
uv lock: Создать lockfile зависимостей проекта.
uv sync: Синхронизировать зависимости проекта с окружением.
uv remove: Удалить зависимость из проекта.
uv add: Добавить зависимость в проект.
uv init: Создать новый Python-проект.

Подробнее в руководстве по проектам.

Инструменты

Запуск и установка инструментов, опубликованных в реестрах Python-пакетов, например ruff или black.

uv tool update-shell: Обновить оболочку, чтобы в PATH попали исполняемые файлы инструментов.
uv tool list: Показать установленные инструменты.
uv tool uninstall: Удалить инструмент.
uv tool install: Установить инструмент для пользователя.
uvx / uv tool run: Запустить инструмент во временном окружении.

Подробнее в руководстве по инструментам.

Интерфейс pip

Ручное управление окружениями и пакетами — для устаревших workflow или случаев, когда высокоуровневых команд недостаточно.

Создание виртуальных окружений (замена venv и virtualenv):

uv venv: Создать новое виртуальное окружение.

Подробнее в документации по использованию окружений.

Управление пакетами в окружении (замена pip и pipdeptree):

uv pip tree: Показать дерево зависимостей окружения.
uv pip uninstall: Удалить пакеты.
uv pip list: Показать установленные пакеты.
uv pip check: Проверить совместимость пакетов в текущем окружении.
uv pip freeze: Показать установленные пакеты и их версии.
uv pip show: Показать сведения об установленном пакете.
uv pip install: Установить пакеты в текущее окружение.

Подробнее в документации по управлению пакетами.

Фиксация пакетов в окружении (замена pip-tools):

uv pip sync: Синхронизировать окружение с lockfile.
uv pip compile: Собрать requirements в lockfile.

Подробнее в документации по фиксации окружений.

Важно: Эти команды не полностью повторяют интерфейс и поведение инструментов, на которых они основаны. Чем сильнее вы отклоняетесь от типичных сценариев, тем вероятнее отличия. Подробности см. в руководстве по совместимости с pip.

Служебные команды

Управление и просмотр состояния uv: кэш, каталоги хранения, самообновление.

uv self update: Обновить uv до последней версии.
uv python dir: Показать путь к каталогу установленных версий Python.
uv tool dir: Показать путь к каталогу инструментов uv.
uv cache dir: Показать путь к каталогу кэша uv.
uv cache prune: Удалить устаревшие записи кэша.
uv cache clean: Удалить записи кэша.

Дальнейшие шаги

Читайте руководства для обзора каждой возможности, страницы концепций для деталей о работе uv или получение помощи, если возникнут проблемы.