O Comando git config

O comando git config é uma ferramenta essencial no Git para configurar variáveis que controlam a aparência e o comportamento do Git em diversos níveis. Essas configurações podem ser desde o seu nome e e-mail de usuário até opções mais complexas de comportamento do repositório ou do sistema.

Níveis de Configuração

O Git tem três níveis principais para armazenar configurações, com precedência da mais específica para a mais geral:

• --local (repositório):
  • Estas configurações são específicas para um único repositório Git.
  • São armazenadas no arquivo .git/config dentro do diretório do seu repositório.
  • Prevalece sobre as configurações globais e do sistema.
  • Exemplo: git config --local user.name "Seu Nome (Projeto X)"
• --global (usuário):
  • Estas configurações se aplicam a todos os repositórios para o seu usuário no sistema operacional.
  • São armazenadas no arquivo ~/.gitconfig (em sistemas Unix/Linux/macOS) ou C:\Users\\.gitconfig (no Windows).
  • Prevalece sobre as configurações do sistema.
  • Exemplo: git config --global user.email "seu.email@example.com"
• --system (sistema):
  • Estas configurações são aplicadas a todos os usuários e a todos os repositórios no sistema.
  • São armazenadas em um arquivo gitconfig que geralmente se encontra em /etc/gitconfig (Unix/Linux/macOS) ou C:\ProgramData\Git\config (Windows).
  • É o nível de configuração menos específico.
  • Exemplo: git config --system core.editor "vim"

Quando você executa git config sem especificar um nível (por exemplo, --local, --global, --system), ele assume --local por padrão se você estiver dentro de um repositório Git, ou --global se você não estiver em um repositório.

Configurações Comuns

Algumas das configurações mais frequentemente usadas incluem:

• user.name e user.email: Define o nome e o endereço de e-mail que serão usados nas suas confirmações (commits).
• core.editor: Define o editor de texto padrão que o Git usará quando precisar que você digite uma mensagem (por exemplo, para um commit ou rebase).
• alias.: Cria atalhos (aliases) para comandos Git mais longos.
• color.ui: Habilita ou desabilita cores na saída do Git.

Exemplos de Uso

Definir seu nome e e-mail (globalmente):

git config --global user.name "Seu Nome Completo"
git config --global user.email "seu.email@example.com"

Definir um editor de texto padrão (globalmente):

git config --global core.editor "nano"

Ou para VS Code:

git config --global core.editor "code --wait"

Definir uma configuração específica para um repositório:

git config --local user.name "Seu Nome (Nome do Projeto)"

Criar um alias para um comando:

git config --global alias.co checkout
git config --global alias.br branch
git config --global alias.ci commit
git config --global alias.st status

Agora você pode usar git co em vez de git checkout, git ci em vez de git commit, etc.

Visualizando Configurações

Listar todas as configurações ativas:

Isso mostrará as configurações de todos os níveis que se aplicam ao seu ambiente e repositório atual, com as configurações de maior precedência aparecendo por último se houver sobreposição.

git config --list

Listar configurações de um nível específico:

git config --list --global
git config --list --local
git config --list --system

Obter o valor de uma configuração específica:

git config user.name
git config core.editor

Remover uma configuração:

Para remover uma configuração, você especifica a chave e o nível.

git config --global --unset user.name

O comando git config é uma ferramenta poderosa para personalizar sua experiência com o Git, garantindo que suas ferramentas e identidade estejam sempre alinhadas com suas necessidades.