Nomes associados ao histórico
As Git refs são referências que associam nomes a objetos do repositório. Uma branch local chamada main usa a referência refs/heads/main para indicar seu commit atual. Assim, você pode consultar a branch pelo nome sem digitar o identificador completo do commit.
Quando você cria um commit na branch atual, o Git atualiza a referência para a nova posição no histórico. O nome continua igual, mas o objeto apontado muda. Uma tag anotada funciona de outra forma: sua referência aponta para um objeto de tag, que guarda informações da marcação e referencia o objeto marcado.
Consultar uma referência pelo nome completo
Em um repositório que possui a branch local main, este comando consulta somente essa referência:
git show-ref --verify refs/heads/mainA saída apresenta o identificador do objeto seguido de refs/heads/main. A opção --verify exige o caminho exato, evitando confundir essa branch com uma tag ou outra referência chamada main. Quando a referência não existe, o comando termina com código 1 e informa o erro. A consulta não altera arquivos nem cria commits.
Para registrar qual revisão foi examinada, guarde o identificador retornado junto do nome completo. Consultar main novamente após novos commits pode produzir outro identificador.
O estado remoto também tem uma referência local
Uma referência como refs/remotes/origin/main registra a última posição conhecida daquela branch no servidor. Sua leitura consulta o repositório local e pode mostrar um estado anterior ao remoto. Você precisa obter as atualizações do servidor para conferir mudanças posteriores à última comunicação.
Dúvidas frequentes
Perguntas frequentes sobre Git refs
- Uma referência sempre aponta diretamente para um commit?
- As referências de branches apontam para commits. Uma tag anotada aponta para um objeto de tag, que por sua vez referencia outro objeto. Há também referências simbólicas, como o HEAD normalmente associado à branch atual.
- É necessário editar os arquivos de refs manualmente?
- Use os comandos do Git para consultar e atualizar referências. O armazenamento pode incluir referências agrupadas, por isso ler apenas um arquivo em .git/refs não cobre necessariamente todas elas.
- Consultar uma referência atualiza o repositório remoto?
- O comando git show-ref consulta o repositório local. Uma referência de acompanhamento remoto registra o último estado obtido do servidor, sem consultar a rede a cada leitura.
Para continuar
Recursos relacionados
Documentação
Pro Git: referências do repositório
Capítulo do Pro Git que explica referências de branches, tags, HEAD e acompanhamento de branches remotas.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Orientação ao vivo no seu repositório para conferir referências e investigar diferenças entre branches durante o desenvolvimento.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Durante o desenvolvimento com agentes, as referências do Git permitem conferir a branch utilizada e registrar o commit examinado na revisão.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.