🧭 Uma bússola dentro do Git: `HEAD`
Entendendo o HEAD 🧭
Vou representar Git como um conjunto de nós que apontam uns para os outros, assim a explicação fica mais simples. Esses nós seriam os commits (Figura 1).
Figura 1 - Árvore de 3 commits
O HEAD é simplesmente uma referência, um ponteiro, para um commit (geralmente o último feito, na Figura 1 é 75e274c).
Quando o commit para o qual ele aponta não é o atual (isto é, NÃO É o último commit feito, NÃO é o topo do branch) isso se chama detached HEAD (ou HEAD desacoplado, Figura 2).
Figura 2 - HEAD detached
Por ser possível "desacoplar", nós podemos movimentar o HEAD para qualquer commit que a gente consiga identificar. Dois comandos que permitem fazer essa movimentação são:
git checkout <commit-hash>git switch -d <commit-hash>
Em resumo, o HEAD fornece uma abstração, um nome, para um commit e permite fazer movimentações e operações com ele de forma mais fluida.
🔎 Verificando para onde HEAD aponta
Tá. Eu entendi o que é o HEAD, mas como eu vejo para onde ele está apontando?
Bem, isso é possível por meio de vários comandos, entre eles:
git log -1(que mostra somente para onde HEAD aponta)git refloggit show HEAD
Que resultam em representações semelhantes a
941fb2b (HEAD -> main, origin/main) adiciona a feature
Nessa mensagem é possível ver HEAD -> main (HEAD aponta para main, que é uma branch).
Pode parecer estranho que, quando defini HEAD, não falei direito sobre branches e HEAD tá apontando para uma agora.
Long-story short (já que o escopo do post não é sobre branchs): branches também são ponteiros e também apontam para commits. Então HEAD apontar para main é o mesmo que apontar para o commit que main aponta.
Dentro do .git
Também dá para ver o HEAD acessando o diretório .git e acesando o arquivo de nome HEAD.
cat .git/HEAD -> ref: refs/heads/main
Ele aponta para main que é uma branch. Para ver para onde main aponta, fazemos
cat .git/refs/heads/main -> 75e274cf0ecdb3141e447d21e987a510b6f47f0b
Pronto: main aponta para um commit, logo HEAD aponta para um commit quando aponta para main.
Se o HEAD estiver detached ele vai apontar diretamente para o commit
cat .git/HEAD -> 75e274cf0ecdb3141e447d21e987a510b6f47f0b
🗺 Usando HEAD^ e HEAD~n para voltar no tempo
Agora, HEAD^ e HEAD~n. Esses operadores podem ser usados em branches e commits também, mas eu vejo muito mais casos em que eles vêm acompanhando o HEAD.
O HEAD^ faz referencia ao commit pai do HEAD (ou seja, o commit que vem antes). Voltando à Figura 1, o commit pai de 75e274c é o b98136f. Veja a Figura 3:
Figura 3 - HEAD^ e HEAD^^
Só que ficar usando vários ^ em sequencia fica inconveniente bem rápido. Para voltar um número maior de commits, temos o HEAD~n.
Nesse operador, n é o número de commits que você quer voltar (HEAD^ e HEAD~1 são equivalentes).
Figura 4 - Voltando commits com HEAD~n
Ambos são muitos úteis quando precisamos voltar nos commits, por exemplo em um git reset HEAD~3.
Basicamente é isso. Não é muito, e nem perto de ser tudo, mas é um pouquinho de algo muito interessante e que ajuda a ter uma experiência melhor com o Git que é uma ferramenta incrível.