Skip to main content

Краткое руководство по GitHub Code Quality

Просмотрите результаты проверки качества кода, создайте Copilot Autofix и объедините запрос на вытягивание для повышения надежности и удобства обслуживания с GitHub Code Quality.

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

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

GitHub Code Quality доступен для:

  • Общедоступные репозитории для GitHub.com
  • Репозитории, принадлежащие организации, на GitHub Team или GitHub Enterprise Cloud

Введение

GitHub Code Quality (public preview) помогает сохранить надежность и удобство обслуживания кода, отображая результаты оценки качества кода в запросах pull и в ветке по умолчанию.

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

Предпосылки

  • GitHub Code Quality должны быть включены для вашего репозитория, и у вас должен быть код на поддерживаемом языке. См . раздел AUTOTITLE.
  • Если вы включаете GitHub Code Quality впервые, убедитесь, что вы подождали несколько минут после включения, пока завершится сканирование ветви по умолчанию.

Просмотр результатов сканирования для ветви по умолчанию

В репозитории перейдите на вкладку Безопасность , нажмите Качество кода на левой боковой панели, затем нажмите Стандартные выводы , чтобы открыть панель управления репозитория.

Здесь вы увидите:

  •         **Оценки надежности** и **удобства обслуживания** базы кода, которые помогают быстро понять работоспособность кода.
    
  •         **Список результатов** всех проблем с качеством, обнаруженных в ветви по умолчанию, которые сгруппированы по правилам и языкам.
    

    Скриншот оценок качества кода в виде "Стандартные выводы" для Code Quality.

Определите обнаружение, имеющее большое значение

Используйте фильтры панели мониторинга , чтобы определить высокий уровень серьезности («Ошибка» или «Предупреждение»).

Устранение этих проблем окажет наибольшее влияние на рейтинги репозитория.

Скриншот, показывающий фильтры панели мониторинга для представления "Стандартные выводы".

Изучите детали находки

Щелкните само название правила, чтобы просмотреть подробные сведения о файлах и строках кода, на которые распространяется это правило.

Скриншот, показывающий правило в виде "Стандартные выводы". Название правила выделено темно-оранжевым цветом.

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

Скриншот результатов для правила "Перезаписанное свойство". Текст «Показать еще» выделен темно-оранжевым цветом.

Сгенерируйте Copilot Autofix

Справа от выделенной находки нажмите Generate fix.

Скриншот кнопки "Generate fix".

Просмотрите предложенное исправление и нажмите Открыть запрос на вытягивание.

Слияние исправления

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

Наблюдайте за изменением метрик

Вернитесь на панель управления Code Quality (вкладка Безопасность , затем Качество кода, затем Стандартные выводы).

Подождите несколько минут, пока не завершится следующее сканирование — Code Quality сканирования автоматически перезапускаются после каждой отправки в ветку по умолчанию.

Следите за изменением метрик в верхней части панели мониторинга:

  •         **Количество выводов** по «Надежности» или «Ремонтопригодности» должно было уменьшиться.
    
  • Ваши оценки «Надежность» или «Ремонтопригодность» могли улучшиться, если в исправлении был учтен ряд важных выводов.

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

Conclusion

Вы успешно использовали Code Quality и Copilot Autofix для улучшения работоспособности кода вашего репозитория!

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

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

  • Узнайте, как GitHub Code Quality работает с запросами на вытягивание, чтобы предотвратить попадание проблем с качеством кода в ветку по умолчанию. См . раздел AUTOTITLE.
  • Оставьте отзыв о GitHub Code Quality в обсуждении сообщества.