Skip to main content

Устранение блокировки в запросе на вытягивание

Определите и устраните блок качества кода в запросе на вытягивание, чтобы можно было объединить изменения.

Кто может использовать эту функцию?

Пользователи с доступом на запись

Примечание.

GitHub Code Quality в настоящее время находится в public preview и может быть изменен. Во время public preview, Code Quality не будут оплачиваться, хотя Code Quality сканирование займет GitHub Actions минут.

Понимание причин блокировки запроса pull

Администраторы репозитория могут установить шлюзы качества кода для удобства обслуживания и надежности, используя GitHub Code Quality. Когда вы открываете запрос на вытягивание, автоматически запускается сканирование для проверки изменений на соответствие этим стандартам.

Если ваш запрос pull содержит код, который не соответствует требуемому порогу качества, вы увидите баннер блока слияния в нижней части запроса на вытягивание в разделе «Проверки»: «Объединение заблокировано: обнаружены результаты проверки качества кода».

Скриншот баннера блока объединения в разделе «Проверки» пул-реквеста.

Эти проверки помогают поддерживать работоспособность, удобную в обслуживании кодовую базу и предотвращать накопление технического долга.

Просмотр результатов сканирования и их уровней серьезности

Результаты сканирования отображаются в виде комментариев к вашему запросу на вытягивание, оставленных .github-code-quality[бот] Каждый комментарий соответствует определенной проблеме с качеством кода, которая была обнаружена в ваших изменениях.

Комментарии помечаются по степени серьезности (Ошибка, Предупреждение, Примечание). Дополнительные сведения о том, что означают уровни серьезности, см. в разделе Уровни серьезности.

Определение того, какие результаты блокируют запрос на вытягивание

Шлюз качества, установленный администраторами репозитория, определяет минимальный уровень серьезности , который будет блокировать слияние.

На баннере блока объединения может быть указан минимальный уровень важности. Все обнаружения с этим уровнем серьезности или выше должны быть устранены, прежде чем вы сможете объединить запрос на вытягивание.

Скриншот баннера блока объединения в разделе «Проверки» пул-реквеста.

Примечание.

Если вы не видите уровень серьезности, определенный в баннере блока слияния, это означает, что ваш репозиторий использует самые строгие пороговые значения качества кода, которые требуют устранения всех обнаруженных результатов перед слиянием.

Исправление или отклонение каждой находки

Чтобы разблокировать запрос на вытягивание, необходимо решить все необходимые проблемы, решив, следует ли исправить проблему в коде или отклонить комментарий.

Использование Автофикс второго пилота и Агент кодирования Copilot для исправления результатов

Автофикс второго пилота

Комментарии к запросу pull включают предлагаемое автоисправление , которое вы можете зафиксировать непосредственно в своем запросе pull. Внимательно изучите предложенное автоисправление на предмет логики, безопасности и стиля, затем нажмите «Предложить фиксацию».

Вам не нужна лицензия Copilot, чтобы применить эти предложения.

Агент кодирования Copilot

В качестве альтернативы, если у вас есть лицензия Copilot, вы можете делегировать работу по исправлению Агент кодирования Copilot. Прокомментируйте запрос на вытягивание с упоминанием @Copilot и попросите Copilot исправить обнаруженные проблемы.

Скриншот с комментарием PR, который вызвал агент кодирования Copilot.

Copilot отвечает эмодзи глаз (👀) на ваш комментарий, запускает новую сессию агента и открывает запрос на вытягивание с необходимыми исправлениями.

Вы можете отслеживать для вызова Агент кодирования Copilot.
Зарегистрируйтесь для Copilot

Отклонение находки

Вы можете отклонить вывод, если он не имеет отношения к вашей кодовой базе или не требует действий. Распространенные причины для отклонения заключения включают:

  • Находка содержится в устаревшем коде, который больше не поддерживается.
  • Это известное исключение из стандартов программирования вашей команды.
  • Это ложное срабатывание, которое не представляет реального риска для качества.

Отклонение неактуальных оповещений позволяет вашим проверкам качества сосредоточиться на значимых проблемах.

Проверка соответствия требованиям

Чтобы проверить, выполнили ли вы требования к качеству кода, посмотрите раздел «Проверки» в нижней части вашего запроса на вытягивание. Баннер блока слияния больше не должен отсутствовать, и вы должны иметь возможность объединять свои изменения как обычно.

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

Уменьшите технический долг за счет исправления результатов в недавно измененных файлах. См . раздел AUTOTITLE.