{"meta":{"title":"Повышение качества кода репозитория","intro":"Оценивайте и устраняйте проблемы с качеством кода, обнаруженные в ветви по умолчанию, чтобы улучшить качество базы кода. По мере продвижения вы увидите, как рейтинг качества кода вашего репозитория будет повышаться.","product":"Безопасность и качество кода","breadcrumbs":[{"href":"/ru/enterprise-cloud@latest/code-security","title":"Безопасность и качество кода"},{"href":"/ru/enterprise-cloud@latest/code-security/tutorials","title":"Tutorials"},{"href":"/ru/enterprise-cloud@latest/code-security/tutorials/improve-code-quality","title":"Улучшение качества кода"},{"href":"/ru/enterprise-cloud@latest/code-security/tutorials/improve-code-quality/improve-your-codebase","title":"Улучшите свою кодовую базу"}],"documentType":"article"},"body":"# Повышение качества кода репозитория\n\nОценивайте и устраняйте проблемы с качеством кода, обнаруженные в ветви по умолчанию, чтобы улучшить качество базы кода. По мере продвижения вы увидите, как рейтинг качества кода вашего репозитория будет повышаться.\n\n> \\[!NOTE]\n> GitHub Code Quality в настоящее время находится в public preview и может быть изменен.\n> Во время public preview, Code Quality не будут оплачиваться, хотя Code Quality сканирование займет GitHub Actions минут.\n\n## Введение\n\nЭто руководство проведёт вас через GitHub Code Quality обзор, приоритетизацию и устранение проблем со здоровьем кода в вашем репозитории — помогая систематически сократить технический долг, повысить надёжность и поддерживаемость, а также донести свой вклад до заинтересованных сторон.\n\n### Предпосылки\n\n* ```\n Code Quality включена для вашего репозитория. См [. раздел AUTOTITLE](/code-security/code-quality/how-tos/enable-code-quality).\n ```\n* Если вы включаете GitHub Code Quality его впервые, убедитесь, что вы подождали несколько минут после включения, чтобы полностью CodeQL сканировать стандартную ветку.\n\n## 1. Оцените общую работоспособность кода репозитория\n\n1. Перейдите на ** Security and quality** вкладку вашего репозитория, затем под « Качество кода», нажмите **Стандартные выводы**.\n2. Обзор на панели «Стандартные выводы» даёт вам мгновенную оценку состояния вашей ветки по умолчанию на сегодняшний день:\n\n * ```\n **Рейтинг поддерживаемости** отражает наличие и серьезность обнаруженных данных о мертвом коде, дублировании, сложности, отсутствующей документации и несоблюдении рекомендаций.\n ```\n * ```\n **Рейтинг надежности** отражает наличие и серьезность результатов проверки правильности, производительности, обработки ошибок, параллелизма и специальных возможностей кода.\n ```\n\n \n\n## 2. Определите и приоритизируйте наиболее значимые результаты\n\nВ виде \"Стандартные выводы\" вы увидите список результатов из Code Qualityпоследнего сканирования ветки по умолчанию репозитория. Эти выводы заключаются в следующем:\n\n* Сгруппированы по **правилам**, чтобы вы могли видеть, какие типы проблем больше всего влияют на вашу кодовую базу.\n* Присваивается уровень **важности** («Ошибка», «Предупреждение», «Примечание»).\n\n### Сосредоточьтесь на результатах с высокой степенью серьезности\n\nИспользуйте **фильтры** панели мониторинга, чтобы в первую очередь сосредоточиться на результатах с самым высоким уровнем серьезности («Ошибки») и проверить, какие правила вызывают больше всего проблем.\n\n\n\nЧтобы повысить удобство обслуживания или надежность репозитория, необходимо устранить (исправить или отклонить) все результаты с самым высоким уровнем серьезности для этой метрики.\n\nНапример, чтобы улучшить метрику \"Надежность\" репозитория с **\"Требуется улучшение** \" до **\"Удовлетворительно**\", необходимо рассмотреть и устранить все **обнаруженные ошибки на уровне ошибок, влияющие** на надежность. Если у вас есть одна или несколько обнаруженных ошибок на уровне ошибки, ваш рейтинг не может быть выше «Требует улучшения». См [. раздел AUTOTITLE](/ru/enterprise-cloud@latest/code-security/code-quality/reference/metrics-and-ratings).\n\n## 3. Изучите группу выводов и поймите контекст\n\nПосле того как вы определили правило с несколькими результатами, которые вы хотите устранить, вы можете продолжить исследование, чтобы понять основные проблемы.\n\n1. Щелкните имя правила, чтобы перейти к подробному просмотру всех результатов для этого правила.\n\n \n\n2. ```\n **Нажмите Показать больше**, затем ознакомьтесь с объяснением правила, рекомендуемым исправлением, примерами вспомогательного кода и ссылками.\n ```\n\n \n\n## 4. Выберите варианты исправления\n\nОцените все выделенные выводы на предмет достоверности, влияния и риска. Чтобы повысить свой рейтинг качества, вам необходимо устранить каждую находку, либо исправить ее, либо отклонить.\n\n### Создание автоисправления\n\nЕсли результат выглядит обоснованным и релевантным для вашей кодовой базы, вы можете сгенерировать предлагаемое исправление.\n\n1. Справа от отдельного находки нажмите ** Generate fix**.\n\n2. Внимательно просмотрите различия предложенного изменения и, если вы согласны с ним, нажмите **кнопку Открыть запрос на вытягивание**.\n\n3. В диалоговом окне \"Зафиксировать автоисправление в ветвь\" выберите \"Открыть запрос на вытягивание\", затем нажмите **Зафиксировать изменение**.\n\n > \\[!TIP]\n > В настоящее время невозможно создать автоматические исправления для группы находок в массовом порядке.\n >\n > Если вы хотите устранить несколько находок с помощью одного запроса на вытягивание, повторите шаги 1 и 2 выше, затем в диалоговом окне \"Зафиксировать автоисправление в ветвь\" используйте имя ветви, которое вы уже создали для первого автоисправления, затем выберите \"Открыть запрос на вытягивание\" и **зафиксируйте изменение**.\n >\n > Исправление будет добавлено в существующий черновик запроса на вытягивание для вашей ветви.\n\n4. Когда вы будете готовы, измените статус запроса на вытягивание с «Черновик» на «Готов к проверке» и внимательно изучите предложенные изменения. Дождитесь завершения и прохождения всех проверок CI и автоматических тестов, прежде чем объединять запрос на вытягивание.\n\n### Отклонение результата\n\nВы можете отклонить вывод, если он не имеет отношения к вашей кодовой базе или не требует действий. Распространенные причины для отклонения заключения включают:\n\n* Находка содержится в устаревшем коде, который больше не поддерживается.\n* Это известное исключение из стандартов программирования вашей команды.\n* Это ложное срабатывание, которое не представляет реального риска для качества.\n\nОтклонение неактуальных оповещений позволяет вашим проверкам качества сосредоточиться на значимых проблемах.\n\n1. Чтобы отклонить вывод, нажмите ****.\n2. Находка исчезнет из списка открытых находок. Вы по-прежнему можете просмотреть и повторно открыть отклоненные результаты на вкладке «Отклоненные» в верхней части страницы.\n\n## 5. Измеряйте улучшения и сообщайте о влиянии\n\nПосле завершения работ по устранению вернитесь на панель управления «Стандартные выводы» для просмотра обновлённых показателей надёжности и поддерживаемости.\n\nСообщая заинтересованным сторонам о своем влиянии, подчеркните:\n\n* Любое **уменьшение** количества результатов для «Надежности» или «Ремонтопригодности».\n* Любые **изменения в рейтинге** надежности или ремонтопригодности.\n* Требования, которые были выполнены для достижения изменения рейтинга. Например, исправление всех обнаруженных результатов на уровне \"Предупреждение\" привело к изменению рейтинга с \"Удовлетворительно\" на \"Хорошо\".\n\nИспользуйте улучшения в рейтингах качества и сокращение количества результатов для демонстрации прогресса.\n\n## 6. Применение стандартов качества кода для запросов на вытягивание\n\nЕсли вы еще этого не сделали, настройте пороговые значения качества для запросов на вытягивание, чтобы заблокировать любые изменения в базе кода, которые могут снизить работоспособность базы кода. См [. раздел AUTOTITLE](/ru/enterprise-cloud@latest/code-security/code-quality/how-tos/set-pr-thresholds).\n\n## Дальнейшие шаги\n\n* Еще больше сократите технический долг, исправив результаты в недавно измененных файлах. См [. раздел AUTOTITLE](/ru/enterprise-cloud@latest/code-security/code-quality/tutorials/improve-recent-merges).\n* Оставляйте обратную GitHub Code Quality связь в [обсуждении сообщества](https://github.com/orgs/community/discussions/177488)."}