O que é revisão de código
Revisão de código é a leitura de uma alteração antes de ela ser integrada ao projeto. Você examina o diff, que reúne as diferenças entre versões, entende o que o código faz e compara o resultado com a tarefa que motivou a mudança.
A revisão existe para reduzir a chance de uma falha chegar ao produto sem ser notada. Ela reúne a leitura do comportamento e a conferência das escolhas tomadas no caminho, como a forma de tratar um erro ou o acesso que a rotina utiliza.
Ler as diferenças junto da intenção
As diferenças mostram o que mudou, mas não explicam sozinhas o motivo. Você precisa da descrição da tarefa para saber qual era o objetivo e se a alteração corresponde a ele.
Quando o código reúne mudanças que ninguém solicitou, a revisão perde o foco. Uma correção de mensagem de erro, por exemplo, não deveria reorganizar telas inteiras. Recusar esse trabalho adicional mantém a leitura ligada ao problema que a alteração deveria resolver.
O teste demonstra o comportamento
A revisão é mais útil quando existe uma verificação que reproduz a situação relevante. Um teste unitário confirma o comportamento de uma parte do código, e um teste de caixa-preta observa as entradas e saídas sem examinar a organização interna.
Leia o teste e pergunte qual falha ele conseguiria revelar. Um teste que confirma apenas a existência de um campo não demonstra que a mensagem está correta. O caso precisa percorrer a situação que motivou a mudança e comparar o resultado observado com o esperado.
Manter a integração possível
Uma regressão acontece quando uma alteração quebra algo que funcionava. Ao revisar, você procura os pontos que dependem do que foi mudado, incluindo outras telas e serviços que usam o mesmo trecho.
Essa leitura ajuda a proteger a qualidade de software sem confiar apenas em memória ou em sorte. O objetivo não é revisar tudo, e sim examinar com atenção o que a alteração afeta de fato.
Para conduzir a revisão de um trecho gerado com IA, o Desenvolvimento Colaborativo da Dev Side Studio permite examinar as diferenças, o comportamento esperado e a autorização aplicada durante a execução.
Dúvidas frequentes
Perguntas frequentes sobre Revisão de código
- A revisão de código substitui o teste?
- Não. A leitura procura entender o que a alteração faz e quais caminhos ela inclui. O teste demonstra o comportamento em situações conhecidas. Os dois recursos se completam, porque uma leitura atenta não exercita a aplicação sozinha.
- Aprovar uma alteração bem escrita integra a funcionalidade?
- Não. Um trecho organizado e legível ainda pode alterar uma permissão, tratar um erro de forma diferente ou deixar de cobrir um caso. A revisão precisa examinar o efeito sobre o produto além da aparência do código.
- Qual tamanho de alteração é adequado para revisão?
- Alterações pequenas e delimitadas por um único objetivo são mais fáceis de conferir. Quando uma mudança reúne correção, ajuste de formato e nova funcionalidade ao mesmo tempo, a leitura perde precisão e o retorno fica superficial.
- Como saber o que a alteração pretendia?
- Leia a descrição da tarefa junto do pull request. A intenção declarada orienta a conferência e permite perceber quando o código inclui mudanças além do que foi solicitado.
Para continuar
Recursos relacionados
Documentação
GitHub: revisões de pull request
Como comentar, aprovar e solicitar mudanças em uma alteração proposta.
Abrir recursoDocumentação
Google: práticas de revisão de código
Princípios para conduzir a revisão com foco no que melhora o código e o produto.
Abrir recursoAplicação na formação
Developer Workspace
A revisão de código confere a alteração gerada antes de ela chegar ao repositório compartilhado.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.