Pular para o conteúdo
Programação

Como usar o GitHub Copilot no VS Code para revisar código antes do commit

O GitHub Copilot no VS Code pode revisar um trecho selecionado ou todas as alterações ainda não commitadas, apontando possíveis bugs, problemas de segurança e inconsistências de estilo. Ele funciona como uma segunda leitura rápida, mas não substitui seus testes nem a revisão de outra pessoa.

Neste guia, mostro o caminho mais simples para configurar o Copilot, pedir a revisão e decidir o que fazer com cada comentário. A ideia não é aceitar tudo que a IA sugerir: é usar o recurso para encontrar problemas antes que eles cheguem ao commit ou ao pull request.

Notebook exibindo linhas de código durante o desenvolvimento de software
Imagem ilustrativa de uma rotina de desenvolvimento no editor de código.

O que é a revisão de código do Copilot

A revisão de código é uma função do GitHub Copilot que analisa código e devolve comentários associados aos trechos avaliados. Quando encontra algo relevante, o recurso pode explicar o possível problema e, em alguns casos, oferecer uma alteração sugerida para você aplicar com poucos cliques.

Em termos simples, pense nele como alguém lendo o seu diff — a lista do que mudou no projeto — e perguntando: “essa condição pode falhar?”, “esse dado está sendo validado?” ou “essa alteração quebrou um caso anterior?”. A resposta continua sendo uma sugestão gerada por modelo de IA, não uma prova de que o programa está correto.

O recurso aparece em dois cenários úteis no VS Code:

  • Trecho selecionado: você destaca algumas linhas e pede uma revisão específica.
  • Alterações não commitadas: o Copilot analisa o conjunto de mudanças exibido no Source Control.

O que você precisa antes de começar

  • Visual Studio Code instalado e atualizado;
  • uma conta do GitHub;
  • acesso ao GitHub Copilot, incluindo o plano gratuito quando ele estiver disponível para a sua conta;
  • um projeto aberto no VS Code, de preferência dentro de um repositório Git;
  • alterações reais para revisar, caso você queira analisar o diff completo.

Segundo a documentação do VS Code consultada em 25 de agosto de 2026, a configuração começa pelo ícone do Copilot na barra de status. Ao escolher Use AI Features, você entra com a conta do GitHub e o editor usa a assinatura existente ou apresenta o Copilot Free, com uma franquia mensal de sugestões inline e créditos de IA. Limites e disponibilidade podem mudar, então confira a condição mostrada na sua conta.

Como ativar o GitHub Copilot no VS Code

  1. Abra o VS Code e entre no projeto que deseja analisar.
  2. Clique no ícone do Copilot na barra de status.
  3. Selecione Use AI Features e escolha o método de login.
  4. Conclua a autorização no navegador e volte ao VS Code.
  5. Abra um arquivo de código e confirme que o Copilot está ativo no editor.

Se a opção não aparecer, abra a paleta de comandos com Ctrl + Shift + P no Windows ou Linux, ou Cmd + Shift + P no macOS, e procure por comandos relacionados a “Copilot”. Também vale verificar se você está conectado à conta correta: é comum ter uma conta pessoal e outra corporativa no mesmo computador.

Como revisar um trecho de código

Essa é a forma mais controlada de começar, porque você limita o contexto da análise ao ponto que realmente causa dúvida:

  1. Abra o arquivo no VS Code.
  2. Selecione as linhas que deseja verificar.
  3. Clique com o botão direito sobre a seleção.
  4. Escolha Generate Code > Review.
  5. Leia os comentários no painel Comments e também as marcações exibidas no editor.

Um bom pedido para complementar a revisão é: “procure falhas de validação, entradas nulas e efeitos colaterais; não altere o código ainda”. Esse tipo de instrução define o que você quer investigar e evita que a ferramenta pule direto para uma solução que você ainda não entendeu.

Por exemplo, em uma função que recebe valor de compra e cupom, peça para o Copilot verificar valores negativos, cupons desconhecidos e arredondamento. Você pode até pedir que ele explique o risco em linguagem simples antes de mostrar qualquer correção. Para quem está aprendendo, essa etapa costuma ser mais útil do que aceitar uma alteração pronta.

Como revisar todas as alterações antes do commit

Quando você terminou uma pequena tarefa e quer conferir o conjunto de mudanças, use o fluxo do controle de versão:

  1. Abra Source Control na barra de atividades do VS Code.
  2. Na seção CHANGES, passe o mouse sobre o título.
  3. Clique no botão Copilot Code Review – Uncommitted Changes.
  4. Aguarde a análise e abra os comentários encontrados no editor ou na aba Problems.
  5. Volte ao diff original e confirme se o comentário realmente se aplica à mudança.

A documentação do GitHub informa que essa análise normalmente termina em poucos segundos, mas o tempo varia conforme o tamanho do conjunto de arquivos, a conexão e a disponibilidade do serviço. Se não houver comentário, isso significa apenas que o Copilot não encontrou algo para apontar naquele contexto; não significa que o código esteja livre de defeitos.

Como interpretar e aplicar os comentários

Leia cada sugestão como uma hipótese que precisa de verificação. Primeiro localize a linha, depois entenda qual entrada ou cenário faria o problema aparecer. Só então decida se deve editar o código, responder ao comentário, descartá-lo ou abrir uma tarefa para investigar com mais calma.

Quando o Copilot oferecer uma alteração sugerida, compare o antes e o depois. Confira nomes de variáveis, tratamento de erros, desempenho e compatibilidade com a versão do projeto. Uma correção que resolve um caso pode quebrar outro. Rode os testes automatizados, o linter e, se possível, um teste manual com dados próximos da realidade.

Se o código manipula senhas, tokens ou chaves de API, não os deixe no arquivo só para facilitar a revisão. Separe essas configurações em variáveis de ambiente e revise também as regras do repositório. O JSMS já explicou como usar variáveis de ambiente no Node.js para proteger configurações.

O que o Copilot não deve decidir por você

  • Não aprove uma sugestão só porque ela parece elegante: confirme o comportamento com testes.
  • Não trate “nenhum comentário” como auditoria: a ferramenta pode não perceber um erro de regra de negócio.
  • Não entregue dados sensíveis no prompt: siga as políticas da sua empresa e do repositório.
  • Não ignore o contexto do sistema: uma função pode parecer errada isoladamente e estar correta por causa de uma regra externa, ou o contrário.
  • Não dispense a revisão humana em código crítico: autenticação, pagamentos, saúde e infraestrutura precisam de critérios adicionais.

Na revisão de pull requests pelo GitHub, o Copilot deixa uma revisão do tipo “Comment”, e não uma aprovação nem uma solicitação formal de mudanças. Isso significa que os comentários não contam como aprovação obrigatória e não bloqueiam sozinhos a mesclagem. A decisão do merge continua com a equipe e com as regras configuradas no repositório.

Erros comuns e como resolver

O botão do Copilot não aparece

Confirme o login, a extensão e as atualizações do VS Code. Se a organização usa uma conta GitHub Enterprise, escolha a opção de login correspondente. Também verifique se os recursos de IA não foram desativados por uma política administrativa.

Não há alterações para revisar

O comando de alterações não commitadas depende de um diff. Salve o arquivo, confirme se ele está dentro de um repositório Git e veja se a seção CHANGES realmente contém arquivos modificados. Para testar apenas uma função, use a revisão de seleção.

Os comentários parecem genéricos ou errados

Reduza o trecho analisado, explique a regra de negócio e peça uma justificativa com um exemplo de entrada e saída. Mesmo assim, mantenha a revisão crítica: modelos de IA podem produzir falsos positivos e falsos negativos, especialmente quando o comportamento depende de banco de dados, serviços externos ou configuração de produção.

Vale a pena usar o Copilot para revisar código?

Vale a pena como uma camada rápida antes do commit, principalmente para lembrar validações esquecidas, apontar riscos óbvios e explicar trechos que você ainda não domina. O ganho está em encurtar a primeira leitura, não em transformar o editor em um auditor automático.

Para projetos pessoais e estudos, o fluxo de selecionar um trecho e pedir uma explicação já é suficiente. Em equipes, faz mais sentido revisar o diff inteiro, manter testes e lint no processo e definir claramente que o Copilot sugere, enquanto uma pessoa responde pelo código que será publicado.

Perguntas frequentes

O GitHub Copilot revisa código de graça no VS Code?

O VS Code informa que contas sem uma assinatura podem receber o Copilot Free, com uma franquia mensal de sugestões inline e créditos de IA. A quantidade e a disponibilidade devem ser conferidas na sua conta.

Posso revisar somente uma função?

Sim. Selecione as linhas da função, clique com o botão direito e escolha Generate Code > Review para pedir uma análise daquele trecho.

O Copilot corrige o código automaticamente?

Ele pode oferecer alterações sugeridas em alguns comentários, mas você precisa revisar a proposta, aplicá-la conscientemente e executar os testes antes de fazer o commit.

Uma revisão sem comentários garante que o código está correto?

Não. A ausência de comentários só indica que o Copilot não encontrou algo para apontar naquele contexto. Testes, análise humana e validação da regra de negócio continuam necessários.