Chapters ▾ 2nd Edition

1.6 Primeiros Passos - Configuração inicial do Git

Configuração inicial do Git

Agora que você tem o Git em seu sistema, você vai querer fazer algumas coisas para personalizar o seu ambiente Git. Você deve ter que fazer essas coisas apenas uma vez em qualquer computador; elas permanecerão entre as atualizações. Você também pode alterá-las a qualquer momento executando os comandos novamente.

O Git vem com uma ferramenta chamada git config que permite obter e definir variáveis de configuração que controlam todos os aspectos de como o Git se parece e opera. Essas variáveis podem ser armazenadas em três locais diferentes:

  1. Arquivo [caminho]/etc/gitconfig: Contém valores aplicados a todos os usuários no sistema e em todos os seus repositórios. Se você passar a opção --system para git config, ele lê e escreve especificamente a partir deste arquivo. Como este é um arquivo de configuração do sistema, você precisaria de privilégios administrativos ou de superusuário para fazer alterações nele.

  2. Arquivo ~/.gitconfig ou ~/.config/git/config: Valores específicos pessoalmente para você, o usuário. Você pode fazer com que o Git leia e grave especificamente neste arquivo passando a opção --global, e isso afeta todos os repositórios com os quais você trabalha no seu sistema.

  3. Arquivo config no diretório Git (ou seja, .git/config) de qualquer repositório que você esteja usando no momento: Específico para aquele único repositório. Você pode forçar o Git a ler e escrever neste arquivo com a opção --local, mas isso é de fato o padrão. Sem surpresa, você precisa estar localizado em algum lugar de um repositório Git para que esta opção funcione corretamente.

Cada nível substitui os valores no nível anterior, portanto, os valores em .git/config superam os de [caminho]/etc/gitconfig.

Em sistemas Windows, o Git procura o arquivo .gitconfig no diretório $HOME (C:\Users\$USER para a maioria das pessoas). Ele também ainda procura por [caminho]/etc/gitconfig, embora seja relativo à raiz do MSys, que é onde quer que você decida instalar o Git em seu sistema Windows ao executar o instalador. Se você estiver usando a versão 2.x ou mais recente do Git para Windows, também existe um arquivo de configuração no nível do sistema em C:\Documents and Settings\All Users\Application Data\Git\config no Windows XP, e em C:\ProgramData\Git\config no Windows Vista e mais recentes. Este arquivo de configuração só pode ser alterado por git config -f <arquivo> como administrador.

Você pode visualizar todas as suas configurações e de onde elas vêm usando:

$ git config --list --show-origin

Sua Identidade

A primeira coisa que você deve fazer ao instalar o Git é definir o seu nome de usuário e endereço de e-mail. Isso é importante porque todo commit do Git usa essas informações e elas estão incorporadas de forma imutável nos commits que você começa a criar:

$ git config --global user.name "John Doe"
$ git config --global user.email johndoe@example.com

Novamente, você precisa fazer isso apenas uma vez se passar a opção --global, porque então o Git sempre usará essas informações para o seu usuário nesse sistema. Se você quiser substituir isso com um nome ou endereço de e-mail diferente para projetos específicos, poderá executar o comando sem a opção --global quando estiver nesse projeto.

Muitas das ferramentas de GUI ajudarão você a fazer isso quando as executar pela primeira vez.

Seu Editor

Agora que sua identidade está configurada, você pode configurar o editor de texto padrão que será usado quando o Git precisar que você digite uma mensagem. Se não estiver configurado, o Git usará o editor padrão do seu sistema.

Se você quiser usar um editor de texto diferente, como o Emacs, pode fazer o seguinte:

$ git config --global core.editor emacs

Em um sistema Windows, se você quiser usar um editor de texto diferente, deverá especificar o caminho completo para seu arquivo executável. Isso pode ser diferente dependendo de como o seu editor está empacotado.

No caso do Notepad++, um editor de programação popular, é provável que você queira usar a versão de 32 bits, já que, no momento da escrita, a versão de 64 bits não suporta todos os plug-ins. Se você estiver em um sistema Windows de 32 bits, ou se tiver um editor de 64 bits em um sistema de 64 bits, digitará algo assim:

$ git config --global core.editor "'C:/Program Files/Notepad++/notepad++.exe' -multiInst -notabbar -nosession -noPlugin"
Note

O Vim, Emacs e Notepad++ são editores de texto populares frequentemente usados por desenvolvedores em sistemas baseados em Unix como Linux e macOS ou um sistema Windows. Se você estiver usando outro editor, ou uma versão de 32 bits, encontre instruções específicas sobre como configurar o seu editor favorito com o Git em Comandos git config core.editor.
Warning

Você pode descobrir que, se não configurar seu editor dessa forma, ficará em um estado muito confuso quando o Git tentar iniciá-lo. Um exemplo em um sistema Windows pode incluir uma operação do Git encerrada prematuramente durante uma edição iniciada pelo Git.

O nome do seu branch padrão

Por padrão, o Git criará um branch chamado master quando você criar um novo repositório com git init. A partir da versão 2.28 do Git, você pode definir um nome diferente para o branch inicial.

Para definir main como o nome do branch padrão, faça:

$ git config --global init.defaultBranch main

Verificando suas configurações

Se você quiser verificar suas definições de configuração, pode usar o comando git config --list para listar todas as configurações que o Git pode encontrar naquele ponto:

$ git config --list
user.name=John Doe
user.email=johndoe@example.com
color.status=auto
color.branch=auto
color.interactive=auto
color.diff=auto
...

Você pode ver as chaves mais de uma vez, porque o Git lê a mesma chave de arquivos diferentes ([caminho]/etc/gitconfig e ~/.gitconfig, por exemplo). Nesse caso, o Git usa o último valor para cada chave única que vê.

Você também pode verificar o que o Git pensa ser o valor de uma chave específica digitando git config <chave>:

$ git config user.name
John Doe
Note

Como o Git pode ler o valor da mesma variável de configuração de mais de um arquivo, é possível que você tenha um valor inesperado para um desses valores e não saiba o porquê. Em casos assim, você pode consultar o Git quanto à origem (origin) desse valor, e ele dirá qual arquivo de configuração teve a palavra final na definição desse valor:

$ git config --show-origin rerere.autoUpdate
file:/home/johndoe/.gitconfig	false