Como você usa git log e git diff de forma eficaz?

Question

Accepted Answer

**git log** e **git diff** são ferramentas poderosas para **inspecionar histórico e mudanças**, com muitas opções para filtrar, formatar e comparar. Saber como usá-las efetivamente ajuda você a entender a evolução de um codebase e revisar mudanças com precisão. ## git log — explorando histórico ```bash git log --oneline # compact (one line per commit) git log --oneline --graph --all # visual branch graph of ALL branches git log -p # show the DIFF of each commit (patches) git log --stat # files changed + insertion/deletion counts # FILTERING git log --author="Ann" # commits by an author git log --since="2 weeks ago" # by date git log --grep="login" # commits whose MESSAGE matches git log -S"functionName" # commits that ADDED/REMOVED this code (pickaxe!) git log # history of a specific file git log main..feature # commits on feature not in main ``` O **pickaxe** (`-S`) é especialmente poderoso — encontra commits que introduziram ou removeram uma string específica, ótimo para rastrear quando o código apareceu. ## git diff — comparando mudanças ```bash git diff # working dir vs staged (unstaged changes) git diff --staged # staged vs last commit (what will commit) git diff HEAD # all changes vs the last commit git diff main feature # differences between two branches git diff # between two commits git diff -- # changes to a specific file git diff --word-diff # word-level (not line-level) diff ``` ## Combinações úteis ```text git log --oneline --graph --all → visualize the whole branch structure git log -p -- → full change history of a file (with diffs) git log --follow → file history across renames git blame + git show → who/when/why a line changed (trace context) ``` ## Por que isso importa Entender como usar `git log` e `git diff` efetivamente é valioso para **inspecionar histórico e mudanças**, uma necessidade frequente no desenvolvimento, então é um conhecimento Git prático útil. **`git log`** é como você explora o histórico de um projeto — e conhecer suas opções o transforma de uma lista básica em uma ferramenta poderosa de investigação: **formatação** (`--oneline`, `--graph` para visualizar a estrutura de branches, `--stat` para resumos de mudanças), e especialmente **filtros** (por autor, data, mensagem de commit com `--grep`, por arquivo, por intervalo de branches, e o poderoso **pickaxe `-S`** que encontra commits que adicionaram ou removeram código específico — inestimável para rastrear quando um pedaço de código apareceu ou desapareceu). Esses permitem que você responda eficientemente perguntas reais como "quem mudou isso e quando", "o que mudou no último lançamento", ou "quando essa função foi introduzida". **`git diff`** é como você examina mudanças com precisão — comparando o diretório de trabalho, staging area, commits e branches — essencial para revisar o que você está prestes a fazer commit (`--staged`), comparar branches e entender diferenças. Conhecer **combinações úteis** (visualizar estrutura de branches, rastrear o histórico completo de um arquivo com `--follow` através de renomeações, combinar blame e show para entender por que uma linha mudou) reflete habilidades de investigação eficaz. Como entender a evolução de um codebase e revisar mudanças são necessidades constantes (para debugging, revisão de código, entender histórico e rastrear mudanças), e como `git log` e `git diff` com suas opções poderosas são as ferramentas primárias para isso, entender como usá-las efetivamente — formatação e filtros do log (especialmente o pickaxe), comparações do diff e combinações úteis — é um conhecimento Git valioso e frequentemente aplicado que transforma inspeção de histórico de adivinhação em investigação precisa, uma habilidade útil para entender e navegar na evolução de qualquer codebase.