git config

Configuração e criação de projetos

Lê e altera as configurações do Git

O comando 'git config' lê e grava configurações guardadas como pares chave = valor. Sem escopo, ele atua no repositório atual (.git/config); --global atua no seu arquivo de usuário (~/.gitconfig) e vale para todos os repositórios do computador. Uma configuração do repositório tem prioridade sobre a global. As primeiras configurações de que todos precisam são user.name e user.email, gravadas em cada commit.

Sinopse

git config [--global | --local] <key> [<value>]
git config [--global] --unset <key>
git config [--global] --list
[ ] opcional| ou<arg> valor a substituir... repetível--flag opção

Opções

Clique em uma opção para expandir

Iniciante (3)

Lê ou grava suas configurações de usuário (~/.gitconfig), compartilhadas por todos os repositórios.

RecomendadoDefina identidade e preferências uma vez para todos os projetos

Exemplo

git config --global user.name "Ada Lovelace"

Remove uma configuração.

Quando necessárioRemover uma configuração para voltar ao padrão

Exemplo

git config --unset pull.rebase

Lista cada configuração em vigor, com seu valor.

Quando necessárioDescobrir quais configurações valem e de onde vêm

Exemplo

git config --list --show-origin

Escolhendo a opção certa

Onde ficam as configurações

A mais específica vence

ComandoArquivoVale para
--system/etc/gitconfigTodos os usuários do computador
--global~/.gitconfigTodos os seus repositórios
--local (default).git/configSó este repositório

Exemplos

Definir seu nome

git config --global user.name "Ada Lovelace"

Usado em cada commit.

Definir seu e-mail

git config --global user.email ada@example.com

Também usado em cada commit.

Ler uma configuração

git config user.name

Mostra o valor em vigor aqui.

Nome do branch padrão

git config --global init.defaultBranch main

git init vai começar em main.

Exemplos de fluxos de trabalho

1
git config --global user.name "Ada Lovelace"

Seu nome

2
git config --global user.email ada@example.com

Seu e-mail

3
git config --global init.defaultBranch main

Repositórios novos começam em main

Solução de problemas

Author identity unknown

Causa: user.name / user.email não estão definidos

Defina-os com git config --global

Uma configuração parece ignorada

Causa: Outro escopo a sobrescreve

git config --list --show-origin mostra de onde vem cada valor

Dicas e armadilhas

Boas práticas

  • ✓Defina sua identidade globalmente e sobrescreva por repositório só quando precisar (p. ex. um e-mail de trabalho).
  • ✓Confira as configurações com --show-origin quando algo se comportar de forma estranha.

Erros comuns

  • ✗Fazer commit antes de definir user.name e user.email.
  • ✗Definir um e-mail de trabalho com --global num computador pessoal, ou o contrário.
  • ✗Problemas com aspas: nomes com espaços precisam de aspas.

Perguntas frequentes

A:

~/.gitconfig (no Windows: C:\Users\<you>\.gitconfig).

A:

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