Observação
GitHub Code Quality está atualmente em prévia pública e ficará disponível para o público em geral em 20 de julho de 2026.
Durante prévia pública, Code Quality não será cobrado, embora as verificações Code Quality consumam GitHub Actions minutos. A partir de 20 de julho de 2026, o uso incorrerá em encargos. Consulte GitHub Code Quality Faturamento.
Entendendo por que sua solicitação de pull está bloqueada
Os administradores do repositório podem definir portões de qualidade usando GitHub Code Quality. Ao abrir uma solicitação de pull, as verificações são executadas automaticamente para avaliar suas alterações em relação a esses padrões.
Há dois tipos de blocos:
- Descobertas de qualidade de código: suas alterações introduzem problemas que estão abaixo do limite de qualidade necessário.
- Limiar de cobertura: suas alterações fazem com que a cobertura de código fique abaixo de um mínimo exigido ou façam com que a cobertura caia mais do que o permitido em relação ao branch padrão.
Se o seu pull request introduzir código que fique abaixo do limite de qualidade exigido, você verá um aviso de bloqueio de mesclagem na parte inferior do pull request, na seção "Checks": "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 Autofixo do Copilot e agente de nuvem Copilot para corrigir as descobertas
Autofixo do Copilot
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 Gerenciar sessões de agente.
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.
Como resolver um bloqueio de limite de cobertura
Se o seu pull request for bloqueado por uma regra de limite mínimo de cobertura, você verá um aviso de bloqueio de mesclagem na seção "Checks", com uma mensagem descrevendo qual limite mínimo não foi atingido. Por exemplo:
- "A cobertura de 22,0% está abaixo do mínimo de 50,0%": a cobertura da ramificação da pull request está abaixo da porcentagem mínima de cobertura configurada no conjunto de regras.
- "A cobertura diminuiu em 2,5%, a queda máxima permitida é de 1,0%": as alterações fizeram com que a cobertura caísse mais do que o valor permitido em relação ao branch padrão.
Para desbloquear sua solicitação de pull, você precisa adicionar ou modificar testes para que mais da base de código seja executada:
- Examine o comentário de resumo de cobertura em sua solicitação de pull para identificar quais arquivos ou áreas não têm cobertura.
- Adicione ou atualize testes para aumentar a cobertura de execução.
- Envie suas alterações. A verificação de cobertura será executada novamente automaticamente.
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.