Observação
GitHub Code Quality está atualmente em versão prévia pública e sujeito a alterações. Durante versão prévia pública, Code Quality não será cobrado, embora as verificações de Code Quality consumirão GitHub Actions minutos.
Entendendo por que sua solicitação de pull está bloqueada
Os administradores do repositório podem definir portões de qualidade de código para manutenção e confiabilidade usando GitHub Code Quality. Quando você abre uma solicitação de pull, uma verificação é executada automaticamente para verificar suas alterações em relação a esses padrões.
Se sua solicitação de pull introduzir código que esteja abaixo do limite de qualidade exigido, você verá um banner de bloqueio de mesclagem na seção Verificações, na parte inferior da solicitação de pull: "A mesclagem está bloqueada: foram detectados problemas de qualidade de código".
Essas verificações ajudam a manter uma base de código íntegra e mantenedível e impedem que a dívida técnica se acumule.
Exibindo os resultados do escaneamento e seus níveis de gravidade
Os resultados da verificação são relatados como comentários em sua solicitação de pull, deixados pelo github-code-quality[bot]. Cada comentário corresponde a um problema específico de qualidade de código detectado em suas alterações.
Os comentários são rotulados por severidade (Erro, Aviso, Observação). Para saber mais sobre o que os níveis de severidade significam, consulte os níveis de severidade.
Determinando quais descobertas estão bloqueando sua solicitação de pull
O portão de qualidade definido pelos administradores do repositório define o nível mínimo de severidade que bloqueará a mesclagem.
O banner de mesclagem pode definir o nível mínimo de severidade. Todas as descobertas nesse nível de severidade ou superior devem ser tratadas antes que você possa mesclar sua solicitação de pull.
Observação
Se você não vir um nível de severidade definido no banner de bloqueio de mesclagem, isso significa que seu repositório está usando os limites de qualidade de código mais rigorosos, que exigem que todos os achados sejam resolvidos antes da mesclagem.
Corrigindo ou descartando cada descoberta
Para desbloquear sua solicitação de pull, você precisa resolver cada descoberta necessária decidindo se deseja corrigir o problema em seu código ou ignorar o comentário.
Aproveitando Copilot Autofix e agente de nuvem Copilot para corrigir as descobertas
Copilot Autofix
Os comentários na solicitação pull incluem um autofix sugerido que você pode confirmar diretamente na sua solicitação pull. Analise cuidadosamente a correção automática sugerida para lógica, segurança e estilo e clique em Confirmar sugestão.
Você não precisa de uma licença Copilot para aplicar essas sugestões.
agente de nuvem Copilot
Como alternativa, se você tiver uma Copilot licença, poderá delegar o trabalho de correção para agente de nuvem Copilot. Comente na solicitação de pull mencionando @Copilot e solicite que Copilot corrija os problemas detectados.
Copilot responde com um emoji de olhinhos (👀) ao seu comentário, inicia uma nova sessão de agente e abre um pull request com as correções necessárias.
Você pode acompanhar o trabalho de agente de nuvem Copilot:
- Na solicitação de pull, o resumo é atualizado à medida que o trabalho progride.
- Usando a página de agentes ou os logs de sessão, consulte Acompanhando as sessões do GitHub Copilot.
Você precisa de uma Copilot licença para invocar agente de nuvem Copilot.
Inscrever-se para Copilot
Descartando a conclusão
Você pode descartar um achado se ele não for relevante ou acionável no contexto de sua base de código. Os motivos comuns para ignorar uma descoberta incluem:
- A descoberta está no código legado que não é mais suportado.
- É uma exceção conhecida para os padrões de codificação da sua equipe.
- É um falso positivo que não representa um risco real de qualidade.
Ignorar alertas irrelevantes mantém suas verificações de qualidade focadas em problemas significativos.
Verificando se você atendeu aos requisitos
Para ver se você atendeu aos requisitos de qualidade de código, examine a seção "Verificações" na parte inferior da solicitação de pull. O banner do bloco de mesclagem não deve mais estar presente e você deve ser capaz de mesclar suas alterações como de costume.
Próximas etapas
Reduza a dívida técnica corrigindo descobertas em arquivos alterados recentemente. Confira Aprimorando a qualidade do código mesclado recentemente com a IA.