{"meta":{"title":"Corrigindo problemas de qualidade do código antes de mesclar sua solicitação de pull","intro":"Identifique problemas de qualidade antes que eles cheguem à ramificação padrão e corrija-os com Autofixo do Copilot e agente de nuvem Copilot.","product":"Qualidade de segurança e código","breadcrumbs":[{"href":"/pt/code-security","title":"Qualidade de segurança e código"},{"href":"/pt/code-security/tutorials","title":"Tutorials"},{"href":"/pt/code-security/tutorials/improve-code-quality","title":"Melhorar a qualidade do código"},{"href":"/pt/code-security/tutorials/improve-code-quality/fix-findings-in-prs","title":"Corrigir problemas identificados em PRs"}],"documentType":"article"},"body":"# Corrigindo problemas de qualidade do código antes de mesclar sua solicitação de pull\n\nIdentifique problemas de qualidade antes que eles cheguem à ramificação padrão e corrija-os com Autofixo do Copilot e agente de nuvem Copilot.\n\n> \\[!NOTE]\n> GitHub Code Quality está atualmente em versão prévia pública e sujeito a alterações.\n> 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.\n\n## Introdução\n\nEste tutorial mostra como trabalhar com GitHub Code Quality solicitações de pull para identificar os problemas de qualidade de código que as suas alterações podem introduzir inadvertidamente e como resolver e resolver descobertas de qualidade de código com Autofixo do Copilot e agente de nuvem Copilot.\n\n### Benefícios de identificar problemas antecipadamente\n\nCapturar problemas de qualidade de código antecipadamente mantém a base de código da equipe em forma.\nGitHub Code Quality verifica seu código para:\n\n* **Confiabilidade**: por exemplo, erros lógicos, tratamento de erros não seguros ou condições de corrida que podem fazer com que seu aplicativo falhe ou se comporte de forma imprevisível. Ao resolver esse tipo de problema antecipadamente, você torna seu software mais robusto e confiável para os usuários.\n* **Manutenção**: por exemplo, código duplicado, lógica excessivamente complexa, variáveis não usadas ou violações das práticas recomendadas de codificação. Corrigir esses problemas torna seu código mais limpo e fácil de ler, portanto, as alterações futuras são mais rápidas e menos arriscadas.\n\n## 1. Entender como GitHub Code Quality funciona em solicitações de pull\n\nQuando você abre uma solicitação de pull, GitHub Code Quality usa CodeQL para verificar automaticamente suas alterações em busca de problemas de qualidade, como os descritos acima.\n\nOs resultados da CodeQL 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 e vem com um autofixo sugerido.\n\nOs comentários são rotulados por severidade (**Erro**, **Aviso**, **Observação**), para que você possa ver quais descobertas são as mais críticas a serem resolvidas.\n\n## 2. Priorizar correções com base na gravidade\n\nExamine os comentários e identifique os achados que têm o nível de severidade mais alto (\"Erro\") primeiro.\n\nSe não houver nenhuma conclusão de \"Erro\", procure os resultados do próximo nível de gravidade (\"Aviso\"), e assim por diante.\n\nDescobertas de alta severidade indicam problemas de qualidade de código mais graves que são mais propensos a introduzir problemas de confiabilidade ou manutenção em sua base de código. Ao resolver as descobertas de alta gravidade, você está fazendo o trabalho mais impactante para manter a qualidade do código da sua equipe.\n\n> \\[!NOTE]\n> Um administrador de repositório pode ter definido uma barreira de qualidade de código que **bloqueia a mesclagem** em sua solicitação de pull, caso a solicitação de pull contenha detecções de um nível de severidade específico ou superior. Confira [Resolvendo um bloqueio em sua pull request](/pt/code-security/code-quality/how-tos/unblock-your-pr).\n\n## 3. Aproveitar Autofixo do Copilot ou agente de nuvem Copilot para corrigir resultados\n\n### Autofixo do Copilot\n\nOs 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**.\n\nVocê não precisa de uma licença Copilot para aplicar essas sugestões.\n\n### agente de nuvem Copilot\n\nComo 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.\n\n\n\n```\n 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.\n```\n\nVocê pode acompanhar o trabalho de agente de nuvem Copilot:\n\n* Na solicitação de pull, o resumo é atualizado à medida que o trabalho progride.\n* Usando a [página de agentes](https://github.com/copilot/agents?ref_product=copilot\\&ref_type=engagement\\&ref_style=text) ou os logs de sessão, consulte [Acompanhando as sessões do GitHub Copilot](/pt/copilot/how-tos/use-copilot-agents/cloud-agent/track-copilot-sessions).\n\nVocê precisa de uma Copilot licença para invocar agente de nuvem Copilot. Inscrever-se para Copilot\n\n## 4. Ignorar descobertas irrelevantes\n\nVocê 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:\n\n* A descoberta está no código legado que não é mais suportado.\n* É uma exceção conhecida para os padrões de codificação da sua equipe.\n* É um falso positivo que não representa um risco real de qualidade.\n\nIgnorar alertas irrelevantes mantém suas verificações de qualidade focadas em problemas significativos.\n\n## 5. Envie as alterações e aguarde a verificação\n\nDepois de corrigir ou ignorar as conclusões, faça push das suas alterações para a ramificação associada à sua solicitação de pull.\nGitHub Code Quality examinará automaticamente suas alterações e atualizará os comentários no seu pull request de forma adequada.\n\n## 6. Verifique as classificações de qualidade de código do repositório\n\nQualquer pessoa com acesso de gravação pode exibir as classificações gerais de qualidade de código de um repositório, que resumem o estado da confiabilidade e da manutenção do código em toda a ramificação padrão.\n\nPara exibir as classificações do seu repositório, navegue até a ** Security and quality** guia do seu repositório, expanda ** Qualidade do código** na barra lateral e clique em **Descobertas padrão**.\n\nAo resolver problemas antes de mesclar sua solicitação de pull, você contribuiu diretamente para manter essas classificações.\n\n## Próximas etapas\n\n* Resolva os problemas de qualidade do código em seu branch padrão e entenda as pontuações de confiabilidade e manutenibilidade do repositório. Confira [Aprimorando a qualidade do código do repositório](/pt/code-security/code-quality/tutorials/improve-your-codebase).\n* Forneça comentários sobre GitHub Code Quality na [discussão da comunidade](https://github.com/orgs/community/discussions/177488)."}