Programa
O Git é uma solução poderosa para controle de versão, compartilhamento de código e colaboração em tarefas complexas. Também é fácil acessá-lo pela linha de comando, o que dá um acesso rápido a essa ferramenta valiosa. Mas digitar comandos longos várias vezes por dia pode rapidamente se tornar chato. Então, os engenheiros criaram uma maneira de definir atalhos, chamados de aliases do Git.
Aliases do Git são atalhos personalizados que permitem criar seus próprios comandos para qualquer operação ou conjunto de operações do Git. Isso pode facilitar um pouco a vida, com menos digitação e um fluxo de trabalho adaptado ao seu estilo pessoal ou ao da sua empresa.
Neste tutorial, vamos falar sobre o que são aliases do Git, como usá-los e dar dicas para compartilhá-los de forma responsável. Se você é novo no Git, dê uma olhada no nosso curso Introdução ao Git e no programa Fundamentos do GitHub para ter uma base sólida antes de mergulhar de cabeça.
Fundamentos dos Aliases do Git
Antes de começarmos a criar atalhos personalizados, vamos falar sobre o que são aliases do Git, como funcionam e por que são tão úteis para os desenvolvedores.
O que são aliases do Git?
Um alias do Git é um comando personalizado que você define na sua configuração do Git. É basicamente uma forma rápida de usar os comandos Git mais comuns.
Se você já conhece a linha de comando, pode estar pensando que os aliases do Git parecem muito com os aliases do shell. Mas tem algumas diferenças importantes. Os aliases do shell são atalhos definidos na configuração do seu shell e podem ser usados para qualquer ferramenta de linha de comando, não só para o Git.
Os aliases do Git, no entanto, são definidos dentro da própria configuração do Git e só estão disponíveis quando você usa o comando git. Os aliases do Git também podem ser portáteis, já que eles viajam com a sua configuração do Git. Isso quer dizer que elas podem ser compartilhadas com sua equipe e vão funcionar de maneira consistente em diferentes ambientes. Eles também são mais fáceis do que aliases de shell para documentar e manter como parte da sua configuração de controle de versão. Os desenvolvedores usam aliases do Git pra economizar tempo e energia, reduzir erros de digitação e automatizar seus fluxos de trabalho.
Se você está interessado em incorporar o shell ao seu fluxo de trabalho, confira nossos cursos sobre shell para aprender como fazer isso.
Escopo e persistência do alias
Existem duas categorias principais de aliases: aliases globais e aliases locais. A principal diferença está em onde você define essas funções e onde elas estão disponíveis para uso.
Um alias global está disponível para uso em todos os repositórios do seu sistema. Quando você define um alias global, ele é guardado no seu arquivo de configuração global do Git. Esse é o melhor lugar pra definir os atalhos que você quer usar em todos os lugares.
Só pra avisar sobre usar aliases globais: eles são específicos pra sua máquina. É importante lembrar disso se você estiver trocando de máquina ou ajudando colegas com as deles. Seus aliases globais não vão funcionar na máquina deles.
Um alias local, por outro lado, é específico para um único repositório. Eles ficam guardados no arquivo de configuração desse repositório específico. Os aliases locais são úteis se você precisar de atalhos específicos para um projeto ou quiser fazer testes sem mexer na sua configuração global.
Os aliases locais têm prioridade
É importante lembrar que, se você definir o mesmo alias globalmente e localmente, o alias local vai ter prioridade. Isso quer dizer que o alias local vai ser o que o seu computador usa, ignorando o global enquanto você estiver no repositório local. Assim que você sair desse repositório, o alias global vai voltar a dominar. Esse recurso é útil porque permite substituir as configurações padrão globais por projetos específicos.
Pra saber mais sobre como configurar o Git em diferentes níveis, dá uma olhada em Git Intermediário.
O fluxograma acima mostra que o Git primeiro procura seu alias no arquivo de configuração local. Se não for encontrado lá, o Git verifica o arquivo de configuração global para determinar quais comandos executar.
Criando e configurando aliases do Git
Configurar aliases do Git é bem simples, mas o método que você escolher pode depender do seu fluxo de trabalho, sistema operacional e preferência pessoal.
Métodos de criação
Tem duas maneiras principais de criar um alias Git; você pode criar um novo alias Git usando a linha de comando ou pode editar seu arquivo de configuração Git diretamente.
Usando a linha de comando
A maneira mais fácil de adicionar um alias é com o comando ` git config
`. A receita geral é:
git config alias.<shortcut> <full-command>
Por exemplo, vamos criar um atalho para git commit -m
, que é usado para salvar alterações preparadas no repositório com uma mensagem.
git config --global alias.cm "commit -m"
Esse comando adiciona um novo alias chamado cm
que executa git commit -m
. A bandeira ` --global
` diz que o alias deve estar disponível em todos os seus repositórios. Se você não colocar --global
, o alias vai ser um alias local aplicado ao seu repositório atual.
Depois de criar os aliases que você quer, pode ser uma boa ideia dar uma conferida no que você criou. Você pode usar a linha de comando para ver todos os seus aliases definidos atualmente usando:
git config --get-regexp ^alias\\\\.
Isso vai listar todos os aliases e seus comandos correspondentes. Você também pode conferir um alias específico. Por exemplo, o comando a seguir vai mostrar o valor do alias lg
do seu arquivo de configuração.
git config alias.lg
Essa é uma maneira rápida de confirmar se seus aliases estão configurados corretamente.
Editando o arquivo de configuração diretamente
Quando você usa os comandos acima, seu arquivo de configuração do Git (vamos chamá-lo de arquivo de configuração do Git daqui em diante), seja global ou local, é atualizado com os aliases que você escolheu. Você pode evitar esse processo modificando seu arquivo de configuração diretamente.
Você vai precisar abrir seu arquivo de configuração do Git em um editor de texto e adicionar os aliases na seção “ [alias]
”. No Windows, você geralmente encontra esse arquivo em C:\\Users\\\\.gitconfig
para aliases globais ou .git\\config
em um repositório para aliases locais. No macOS ou Linux, os aliases globais geralmente ficam em ~/.gitconfig
e os locais em .git/config
.
Seu arquivo de configuração do Git deve ficar mais ou menos assim (se for um arquivo global, pode ter mais algumas partes):
[core]
repositoryformatversion = 0
filemode = true
bare = false
logallrefupdates = true
[remote "origin"]
url = <https://github.com/username/repo.git>
fetch = +refs/heads/*:refs/remotes/origin/*
[branch "main"]
remote = origin
merge = refs/heads/main
[alias]
cm = commit -m
Se a gente rolar a tela até a seção “ [alias]
”, dá pra adicionar nossos atalhos personalizados:
[alias]
cm = commit -m
st = status
lg = log --oneline --graph --decorate --all
Essa abordagem pode ser especialmente útil se você quiser adicionar vários aliases ao mesmo tempo. Isso também facilita copiar e colar um conjunto de aliases de um colega ou de um recurso online.
Pra ter uma referência prática dos comandos Git mais comuns, dá uma olhada na nossa Folha de Referência Completa do Git.
Configuração específica do sistema operacional e do shell
Os aliases do Git são definidos dentro da sua configuração do Git, então funcionam em todos os sistemas operacionais e shells. Mas, como você usa isso pode depender do seu ambiente.
No Windows, os aliases do Git funcionam bem no Git Bash e no WSL (Subsistema Windows para Linux). No Prompt de Comando e no PowerShell, aliases simples como st
para status funcionam bem, mas os mais avançados que dependem de recursos do shell, como pipes ou vários comandos, podem não funcionar como esperado. Para aliasing complexo, o Git Bash ou WSL são as melhores opções.
No macOS e no Linux, os aliases do Git geralmente funcionam da mesma forma no Bash, Zsh e outros shells tipo Unix. Aliases simples e complexos podem ser usados sem problemas.
O shell Fish é um caso especial porque usa uma sintaxe diferente do Bash e do Zsh. Alguns aliases avançados do Git que usam a sintaxe do shell POSIX podem não funcionar direito no Fish. Nessas situações, talvez você precise reescrever o alias como uma função shell ou usar aliases Git mais simples.
Para saber mais sobre o básico do shell, dá uma olhada na nossa Folha de Referência Básica do Terminal Bash & Zsh Shell.
Aprenda hoje os fundamentos do Git
Gerenciando aliases do Git
Depois de configurar seus aliases, você vai precisar mantê-los organizados, atualizá-los conforme necessário e resolver quaisquer conflitos que possam surgir.
Listar, atualizar e excluir aliases
Já falamos sobre como você pode ver uma lista dos seus aliases, seja no arquivo de configuração ou na linha de comando. Mas e se você quiser mudar um ou apagar? Felizmente, isso também é bem simples. Pra mudar um alias, você pode executar o comando ` git config
` de novo com um novo valor ou editar a linha relevante diretamente no seu arquivo de configuração.
Remover um alias é igualmente fácil. Na linha de comando, você pode usar o sinalizador ` --unset
` para excluir um alias:
git config --global --unset alias.lg
Ou você pode simplesmente apagar a linha do seu arquivo de configuração. Depois de removido, o alias não estará mais disponível.
Lidando com conflitos e problemas de alias
Às vezes, você pode se deparar com conflitos, como definir o mesmo alias globalmente e localmente. Lembre-se de que os aliases locais substituem os globais dentro do mesmo repositório. Então, se você perceber que seu alias normal não está funcionando direito, dá uma olhada em qual repositório você está e se tem algum alias local definido. Também é uma boa ideia evitar nomes que se confundam com comandos internos do Git, como commit ou push.
Se você mudar de máquina ou atualizar o Git, é uma boa ideia conferir se seus aliases ainda funcionam. E, quando estiver colaborando, pense em documentar seus aliases ou compartilhar um arquivo de configuração comum para que todo mundo tenha acesso aos mesmos atalhos.
Categorias comuns de aliases e casos de uso
Vamos dar uma olhada em algumas categorias diferentes de aliases do Git e como eles podem melhorar suas atividades diárias.
Encurtamento de comando
Um dos usos mais óbvios dos aliases é encurtar comandos longos ou que você usa sempre. Em vez de digitar git checkout main
, você pode usar git co main
ou trocar git status
por apenas git st
. Com o tempo, esses pequenos ajustes podem economizar muito tempo de digitação, tornando seu fluxo de trabalho mais rápido.
Formatação de saída aprimorada
Às vezes, a saída bruta do Git pode ser meio difícil de ler, principalmente com comandos como git log
ou git diff
. Os aliases permitem que você mude o formato da saída para deixá-la mais clara. A gente pode definir uma visualização personalizada do log com cores, datas e ramificações, ou tornar as diferenças mais legíveis com destaque de palavras. Isso pode facilitar muito a identificação de alterações e o programa do histórico.
Por exemplo, a gente pode criar um alias personalizado para git log
pra melhorar a legibilidade da saída:
git config --global alias.lg "log --oneline --graph --decorate --date=short --pretty=format:'%h - (%cd) %an %d %s'"
Agora, em vez de digitar git log e obter esta saída genérica:
commit c2f3d4a6b8e9d55f45e2f98c879f6f43be11a765 (HEAD -> main)
Author: Jane Deer <jdeer@example.com>
Date: Sun Aug 10 14:12:03 2025 -0400
Fix typo in README
commit a7b1e22c0f6a2d876fe4c9d8e00c64e28793d9e0
Author: John Doe <jdoe@example.com>
Date: Tue Aug 5 09:33:45 2025 -0400
Add login validation
A gente consegue uma saída bem mais simples e fácil de ler usando nosso alias git lg:
* c2f3d4a - (2025-08-10) Jane Deer (HEAD -> main) Fix typo in README
* a7b1e22 - (2025-08-05) John Doe Add login validation
Você pode ver como nossa saída com aliases seria bem mais fácil de ler, principalmente se tivesse vinte ou mais entradas em vez de só essas duas.
Automação do fluxo de trabalho
Os aliases também podem funcionar como mini ferramentas de automação para o seu fluxo de trabalho Git. Por exemplo, você pode juntar vários comandos em um único alias que prepara, confirma e envia as alterações em uma única etapa. Esse tipo de automação pode ser útil, principalmente para equipes que usam práticas de DevOps e valorizam a consistência.
Você pode saber mais sobre como o Git se encaixa em fluxos de trabalho de automação mais amplos em CI/CD para machine learning.
Aliases comumente usados e recomendados pela comunidade
Alguns aliases são tão populares que se tornaram essenciais na comunidade Git. Isso inclui atalhos e aliases mais avançados que facilitam a vida. Dá uma olhada na tabela abaixo, que mostra 20 dos aliases Git mais comuns que eu vejo ( ).
Comando total |
Alias |
Função |
|
|
Mostrar o status do diretório de trabalho |
|
|
Trocar de ramificação ou restaurar arquivos |
|
|
Listar, criar ou excluir ramificações |
|
|
Registre as alterações realizadas |
|
|
Confirme com uma mensagem |
|
|
Prepare todas as alterações (novas, modificadas, excluídas) |
|
Desmarcar arquivos sem descartar as alterações |
|
|
|
Mostrar o último commit |
|
|
Visualização bonita do log com gráfico e metadados |
|
|
Outro formato de registro legível com gráfico histórico |
|
Mostrar alterações não preparadas |
|
|
|
Mostrar as alterações feitas |
|
|
Buscar e integrar com o remoto |
|
|
Envie as alterações para o servidor remoto |
|
Reaplique os commits em cima de outra ponta base |
|
|
|
Cancelar uma rebase em andamento |
|
|
Retomar a rebase após corrigir os conflitos |
|
|
Editar o último commit |
|
|
Desfazer o último commit, mas manter as alterações preparadas |
|
|
Atualize todos os controles remotos e elimine os ramos excluídos. |
Técnicas avançadas de alias
Além de encurtar comandos longos, existem algumas técnicas avançadas de alias que oferecem flexibilidade para integrar com seu shell, lidar com parâmetros ou até mesmo personalizar aliases para repositórios específicos.
Integração do comando Shell
Você pode integrar comandos shell diretamente nos seus aliases Git. Colocando um alias com !, o Git vai passar o resto pro seu shell. Isso abre a possibilidade de juntar ações do Git com ferramentas externas, tipo rodar um linter antes de fazer o commit ou encadear vários comandos juntos. Se você é novo em ambientes shell, um recurso como o Bash & zsh Shell Terminal Basics Cheat Sheet pode te ajudar a entender como isso funciona na prática.
Manipulação de parâmetros
Às vezes, você vai querer aliases que não sejam codificados, mas que se adaptem a quaisquer argumentos que você passar. Ao escrever aliases como funções Bash anônimas, você pode aceitar parâmetros e usá-los de forma dinâmica. Essa flexibilidade permite transformar tarefas repetitivas em comandos simples e reutilizáveis, adaptados às suas necessidades.
Por exemplo, vamos criar um alias Git parametrizado que vai procurar um texto específico nos nossos commits. No Windows, você pode fazer isso no Git Bash. No macOS e no Linux, o mesmo alias também funciona, já que o Git o executa em um shell compatível com o Bash.
git config --global alias.find '!f() { git log --grep="$1"; }; f'
Agora, ao executar git find bugfix
, você vai procurar mensagens de commit com “bugfix” e mostrar os commits correspondentes.
Configuração condicional
A diretiva includeIf do Git permite que você carregue diferentes conjuntos de aliases dependendo do repositório ou ambiente. Por exemplo, você pode querer um conjunto de aliases para projetos de trabalho e outro para projetos pessoais. As configurações condicionais mantêm sua configuração organizada, garantindo que as ferramentas certas estejam disponíveis no contexto certo.
No seu arquivo de configuração global do git, você pode incluir:
[includeIf "gitdir:C:/Users/YourName/work/"]
path = C:/Users/YourName/.gitconfig-work
[includeIf "gitdir:C:/Users/YourName/personal/"]
path = C:/Users/YourName/.gitconfig-personal
Depois, dentro de C:/Users/SeuNome/.gitconfig-work, defina aliases como:
[alias]
st = status
lg = log --oneline --graph
E em C:/Users/SeuNome/.gitconfig-personal:
[alias]
st = status -s
co = checkout
Agora, quando você estiver em um repositório em C:/Users/SeuNome/trabalho/, digitar git lg vai usar o alias específico do trabalho, enquanto em C:/Users/SeuNome/pessoal/, git co vai usar o alias pessoal. Mas é importante lembrar em qual diretório você está se usar esse sistema. Você não quer confundir seus apelidos!
Uma observação para usuários de Mac/Linux: basta substituir os caminhos do Windows por caminhos no estilo Unix, por exemplo: ~/trabalho/ ou ~/pessoal/. O comportamento é idêntico em todos os outros aspectos.
Estratégias de manutenção e colaboração
À medida que sua coleção de aliases do Git cresce, manter a clareza e a consistência se torna essencial, especialmente se você estiver colaborando. Vamos falar sobre algumas práticas recomendadas para documentar, compartilhar e proteger seus aliases, para que eles continuem sendo um recurso útil, em vez de se tornarem uma fonte de confusão.
Documentação
Documentar bem os aliases do Git é tão importante quanto documentar todas as outras partes do processo de desenvolvimento. Essa documentação é super importante para os novos membros da equipe e para você mesmo no futuro. Aqui estão algumas estratégias:
- Mantenha uma seção no README do seu projeto para aliases Git específicos do projeto. Para cada alias, descreva resumidamente sua finalidade e uso.
- Ao editar o .gitconfig diretamente, coloque comentários acima de aliases complexos ou não óbvios. Por exemplo:
# Quickly stage, commit, and push changes
acp = !git add -A && git commit -m \\"$1\\" && git push
- Se você trabalha em equipe, pode pensar em padronizar os apelidos usados por todo mundo. E, se sua equipe usa um wiki ou uma plataforma de documentação interna, inclua uma página sobre aliases do Git e atualize-a conforme seu projeto evolui.
Documentação e comunicação claras garantem que todos entendam o que cada alias faz, reduzindo o risco de erros e facilitando a adoção de novos atalhos.
Segurança e validação
Outro ponto a considerar é a segurança. Embora os aliases sejam poderosos, eles também podem trazer riscos se não forem gerenciados com cuidado. Por exemplo, aliases que fazem coisas destrutivas, como apagar branches ou fazer force-push, devem ser bem pensados e testados em dados que não são importantes. A última coisa que você quer é achar que está fazendo algo inofensivo, mas acabar apagando por engano ramificações importantes do seu repositório!
Uma medida que pode salvar sua vida quando você usa aliases Git potencialmente perigosos é a flag ` --dry-run
`. Isso permite que você visualize a ação que está propondo ao usar o alias, sem realmente fazê-la! Por exemplo, digamos que você queira remover o arquivo file.txt usando um alias. Você pode se ajudar executando-o primeiro como um teste para garantir que a ação correta está sendo executada.
git rm --dry-run file.txt
Outra preocupação potencial de segurança são os aliases que executam comandos shell ou scripts externos. Aliases que começam com !
executam tudo o que vem depois no seu shell, o que significa que um alias mal avaliado ou não confiável pode excluir arquivos, roubar dados ou fazer outras coisas ruins. Da mesma forma, aliases que chamam scripts externos podem ser arriscados se o script vier de uma fonte não verificada ou tiver sido modificado. É importante dar uma olhada em cada pseudônimo antes de usá-lo e evitar copiar pseudônimos da internet sem pensar. É por isso que prefiro não misturar comandos Git com comandos shell no mesmo alias.
Conclusão
Os aliases do Git são um recurso poderoso, mas muitas vezes subutilizado, que pode melhorar bastante a produtividade pessoal e da equipe. Ao permitir que você transforme comandos complexos ou repetitivos em atalhos fáceis de lembrar, os aliases ajudam a reduzir a carga cognitiva, minimizar erros de digitação e simplificar seu fluxo de trabalho diário.
Se você tiver mais perguntas ou quiser se aprofundar no assunto, confira o Guia Completo do Git e outros recursos relacionados neste artigo. Se você está curioso para saber outras maneiras de simplificar sua experiência com a linha de comando, também pode gostar de Como usar um alias SQL para simplificar suas consultas.

Sou PhD e tenho 13 anos de experiência trabalhando com dados em um ambiente de pesquisa biológica. Crio software em várias linguagens de programação, incluindo Python, MATLAB e R. Sou apaixonado por compartilhar meu amor pelo aprendizado com o mundo.
Perguntas frequentes
O que é um alias do Git?
Um alias do Git é um atalho personalizado para um ou mais comandos do Git. Eles permitem que você execute rapidamente comandos ou sequências sem precisar digitar muito.
Posso usar aliases do Git em vários repositórios?
Sim. Ao definir um alias Git como global, você poderá usá-lo em vários repositórios. Mas, qualquer alias local vai substituir os globais.
Como faço pra excluir um alias do Git se eu não precisar mais dele?
Pra apagar um alias do Git, você pode abrir o arquivo de configuração do Git e apagá-lo manualmente ou usar o sinalizador --unset na linha de comando.
Como posso personalizar os aliases do Git para o meu fluxo de trabalho específico?
A melhor maneira de personalizar os aliases do Git para o seu fluxo de trabalho específico é pensar nos comandos e sequências que você usa com mais frequência e criar aliases personalizados para simplificá-los ou automatizá-los. Os aliases do Git podem ser super pessoais e simplificar tarefas que você acha chatas.
Os aliases do Git são iguais aos aliases do shell?
Não. Os aliases do Git são definidos no Git e só usam comandos do Git. Os aliases do shell são definidos dentro do seu shell e podem usar comandos de várias ferramentas, incluindo o Git.