Git: a importância do ficheiro .gitconfig e como pode ajudar

22 Ago 2026 · Tutoriais

Quem desenvolve ou gere projetos de código sabe que manter o código organizado e controlar as alterações é fundamental. É neste contexto que ferramentas como o Git assumem um papel importante, permitindo acompanhar alterações, criar diferentes versões e recuperar facilmente versões anteriores.

O que é o ficheiro .gitconfig?

O .gitconfig é um ficheiro onde o Git guarda várias configurações do utilizador. Entre outras opções, permite definir o nome e email associados aos commits, a branch inicial dos novos repositórios, cores no terminal e atalhos para comandos utilizados frequentemente.

No macOS e distribuições Linux, o ficheiro encontra-se normalmente na pasta pessoal do utilizador:

~/.gitconfig

Para verificar se o ficheiro existe, basta abrir o Terminal e executar:

ls -la ~/.gitconfig

Também é possível consultar as configurações atualmente definidas através do próprio Git:

git config --global --list

Definir o nome e o email no Git

Uma das primeiras configurações recomendadas é definir a identidade que será associada aos commits:

git config --global user.name "Pedro Pinto"
git config --global user.email "[email protected]"

A opção --global significa que estas definições serão utilizadas nos diferentes repositórios do utilizador.

Por exemplo, quando for criado um commit:

git commit -m "Atualização"

o Git irá associar o commit ao nome e email configurados.

Dica: quem utiliza o GitHub deve garantir que o endereço de email utilizado está corretamente associado à conta ou utilizar o endereço privado disponibilizado pelo serviço.

Os aliases podem poupar bastante tempo

Uma das funcionalidades mais interessantes do .gitconfig é a possibilidade de criar aliases, ou seja, atalhos para comandos Git.

Por exemplo:

[alias]
st = status
co = checkout
br = branch
ci = commit
cm = commit -m
lg = log --oneline --graph --decorate --all

Depois de configurar estes aliases, em vez de escrever:

git status

podemos simplesmente utilizar:

git st

Definir main como branch principal

Outra configuração útil é definir main como branch principal dos novos repositórios:

[init]
defaultBranch = main

Assim, quando for executado:

git init

a branch inicial será criada com o nome main.

Aqui fica um exemplo mais completo do ficheiro gitconfig.

Para quem utiliza regularmente Git em projetos WordPress, vale a pena dedicar alguns minutos a configurar este ficheiro. Aliases, branches e outras pequenas configurações podem fazer uma diferença significativa no dia a dia.