git alias
Saiba o que são aliases do Git, como criá-los e como usá-los para simplificar comandos Git no dia a dia.
O que é um alias do Git?
Um alias do Git é um atalho personalizado que associa um nome curto e fácil de lembrar a um comando Git mais longo (ou até uma cadeia de comandos). Depois de definido, digitar git co pode executar git checkout, economizando digitação e reduzindo erros em comandos usados dezenas de vezes por dia.
Não existe um comando git alias dedicado. Em vez disso, os aliases são armazenados como entradas de configuração comuns, então você os cria com o comando git config ou editando diretamente um arquivo de configuração do Git. Por serem apenas configuração, os aliases respeitam as regras normais de escopo do Git: defina-os globalmente (em ~/.gitconfig) para que todos os repositórios possam usá-los, ou localmente (no .git/config de um único repositório) quando um alias faz sentido apenas para aquele projeto.
Esta página aborda as duas formas de criar aliases, como verificá-los, como criar aliases para comandos com argumentos, como executar comandos externos de shell a partir de um alias e alguns aliases úteis para adicionar hoje mesmo.
Criando aliases com git config
A forma mais comum de adicionar um alias é o comando git config com a flag --global, que grava em ~/.gitconfig para que o alias esteja disponível em todos os repositórios:
git config --global alias.co checkoutA forma geral é git config --global alias.<atalho> "<comando>". O exemplo acima permite executar git co em qualquer lugar onde git checkout é esperado. Remova --global para limitar o alias ao repositório atual.
Você pode confirmar que o alias foi salvo com git config --list, que exibe todos os valores de configuração ativos:
git config --listA nova entrada aparece na saída como:
alias.co=checkoutA partir de agora, o alias se comporta exatamente como se você tivesse digitado o comando completo. Quaisquer argumentos extras que você passar são repassados ao comando subjacente:
git co -b new-featureIsso executa git checkout -b new-feature, criando e alternando para um branch chamado new-feature.
Criando aliases editando o .gitconfig
Como os aliases são configurações simples, você também pode adicioná-los editando o arquivo de configuração diretamente. Abra ~/.gitconfig (global) ou o .git/config de um repositório (local) e adicione uma seção [alias]:
[alias]
co = checkout
ci = commit
st = statusCada linha em [alias] segue o formato atalho = comando. Isso é exatamente o que git config --global alias.co checkout produz, portanto os dois métodos são intercambiáveis — editar o arquivo é conveniente quando você deseja adicionar vários aliases de uma só vez.
Aliases para comandos com argumentos
Aliases funcionam bem para comandos que sempre recebem as mesmas flags. Por exemplo, um log de uma linha com decorações:
git config --global alias.lg "log --oneline --graph --decorate --all"Executar git lg exibe um histórico compacto em formato de grafo. Consulte git log para entender o que cada flag faz.
Envolva o comando em aspas quando ele contiver espaços ou flags; caso contrário, o shell passa as palavras extras para o git config em vez de armazená-las como parte do alias.
Executando comandos shell a partir de um alias
Para executar um programa externo (não um subcomando do Git), prefixe o valor do alias com !. O Git então executa o restante em um shell:
git config --global alias.visual "!gitk"Essa técnica também serve para combinar várias etapas. O alias abaixo adiciona tudo ao stage e realiza o commit em uma única operação, onde $1 é a mensagem de commit que você passa:
git config --global alias.ac '!f() { git add -A && git commit -m "$1"; }; f'Agora git ac "fix typo" executa git add -A seguido de git commit -m "fix typo".
Aliases Git úteis
Aqui estão alguns aliases que encurtam comandos do dia a dia. Adicione-os com git config --global alias.<nome> "<comando>":
| Alias | Expande para | Descrição |
|---|---|---|
co = checkout | git checkout | Alterna branches ou restaura arquivos. |
cob = checkout -b | git checkout -b | Cria e faz checkout de um novo branch. |
ci = commit | git commit | Registra as alterações em stage. Veja git commit. |
st = status -sb | git status -sb | Exibe um status curto com informação do branch. |
f = fetch -p | git fetch -p | Busca e remove branches de rastreamento remoto obsoletos. |
p = push | git push | Envia alterações para um repositório remoto. |
bd = branch -d | git branch -d | Exclui um branch somente se já foi mesclado. |
ba = branch -a | git branch -a | Lista todos os branches locais e de rastreamento remoto. |
bD = branch -D | git branch -D | Força a exclusão de um branch. |
dc = diff --cached | git diff --cached | Exibe as alterações em stage. |