Получение помощи

Справка по командам

Флаг --help показывает справку по команде, например для uv:

$ uv --help

Чтобы увидеть справку по конкретной команде, например по uv init:

$ uv init --help

С флагом --help uv выводит краткую справку. Чтобы увидеть расширенную справку по команде, используйте uv help:

$ uv help

Расширенная справка по конкретной команде, например по uv init:

$ uv help init

При расширенной справке uv пытается использовать less или more для постраничного вывода. Чтобы выйти из пейджера, нажмите q.

Подробный вывод

Флаг -v включает подробный вывод команды, например для uv sync:

$ uv sync -v

Флаг -v можно повторять для увеличения уровня детализации:

$ uv sync -vv

Подробный вывод часто содержит дополнительную информацию о том, почему uv ведёт себя тем или иным образом.

Проверка версии

При обращении за помощью важно знать версию uv — иногда проблема уже исправлена в более новой версии.

Проверить установленную версию:

$ uv self version

Также допустимы варианты:

$ uv --version      # То же, что `uv self version`
$ uv -V             # Без коммита сборки и даты

Примечание: До uv 0.7.0 использовалась команда uv version вместо uv self version.

Решение проблем

В справочной документации есть руководство по устранению неполадок для типичных ситуаций.

Создание issue на GitHub

Трекер задач на GitHub подходит для сообщений об ошибках и запросов возможностей. Сначала поищите похожие issues — часто ту же проблему уже описывали другие.

Чат в Discord

У Astral есть сервер в Discord — удобное место, чтобы задавать вопросы, узнавать больше об uv и общаться с сообществом.