4.4.2 Configurando o seu Git via `git config`

Agora que você já entendeu como funcionam os escopos de configuração do Git, é hora de ver como gerenciar essas configurações na prática usando a linha de comando.

Embora as configurações do Git sejam armazenadas em arquivos no sistema, não é recomendável editá-los manualmente. Esses arquivos existem para armazenar as configurações que o Git utiliza no dia a dia.

Nesta seção, vamos observar esses arquivos em alguns momentos para entender melhor o comportamento do Git e a forma como ele organiza suas configurações internamente. No entanto, a criação, alteração e remoção de configurações devem ser feitas sempre por meio da linha de comando.

É justamente para isso que existe o comando git config. Ele permite que você gerencie configurações pela CLI, garantindo que os valores sejam gravados no arquivo correto, no escopo adequado, e evitando erros de formatação ou inconsistências.

git config

O comando git config é usado para configurar o Git no seu computador. Neste contexto, configurar significa customizar ou personalizar o Git de acordo com suas preferências e necessidades.

Com esse comando, você consegue, entre outras coisas, listar configurações existentes, consultar valores específicos, alterar informações e remover configurações já definidas. A seguir, veremos esses principais casos de uso.

Listar configurações

Esse uso é indicado quando você quer visualizar quais configurações existem e quais valores estão ativos no momento.

Estrutura

git config --list [opções]

Em que:

• --list: indica que o Git deve listar as configurações disponíveis.

• [opções] (opcional): define modificadores adicionais do comando, como filtrar por escopo ou exibir a origem das configurações.

Exemplos de uso

• Lista todas as configurações visíveis para o Git, considerando todos os escopos

  • git config --list

• Listar as configurações e mostra de qual arquivo cada uma está sendo lida

  • git config --list --show-origin

• Lista apenas as configurações definidas no escopo system

  • git config --list --system

• Listar apenas as configurações definidas no escopo global

  • git config --list --global

• Lista apenas as configurações definidas no repositório atual

  • git config --list --local

Quando uma configuração existe em mais de um escopo, o Git considera apenas o valor que está efetivamente ativo.

Saber o valor de uma configuração

Esse uso é indicado quando você quer consultar o valor atual de uma configuração específica.

Estrutura

git config [escopo] chave

Em que:

• [escopo] (opcional): define o escopo da consulta, como --global, --local ou --system.

• chave: se refere ao nome da configuração que você deseja consultar. Exemplos: user.name, user.email.

Exemplos de uso

• Mostra o valor atualmente ativo da configuração user.name

  • git config user.name

• Mostra o valor de user.name definido no escopo system

  • git config --system user.name

• Mostra o valor de user.name definido no escopo global

  • git config --global user.name

• Mostra o valor de user.name definido no repositório atual

  • git config --local user.name

Alterar ou definir uma configuração

Esse uso é indicado quando você quer criar uma nova configuração ou alterar o valor de uma configuração existente.

Estrutura

git config [escopo] chave valor

Em que:

• [escopo] (opcional): define o escopo em que a configuração será aplicada.

• chave: se refere ao nome da configuração que você deseja definir ou modificar. Exemplos: user.name, user.email.

• valor: se refere ao valor que você deseja atribuir à chave. Exemplos: Aprendiz Cumbuca Dev, [email protected]. Quando o valor contém espaços, ele deve ser colocado entre aspas. Isso indica ao Git que todo o texto faz parte de um único valor, e não de vários argumentos separados.

Exemplos de uso

• Define o valor de user.name no escopo padrão

  • git config user.name "Aprendiz Cumbuca Dev"

• Define o valor de user.name no escopo system

  • git config --system user.name "Aprendiz Cumbuca Dev"

• Define o valor de user.name no escopo global

  • git config --global user.name "Aprendiz Cumbuca Dev"

• Define o valor de user.name apenas para o repositório atual

  • git config --local user.name "Aprendiz Cumbuca Dev"

Quando uma configuração existe em mais de um escopo, o Git utiliza sempre o valor definido no escopo mais específico.

Apagar uma configuração

Esse uso é indicado quando você quer remover uma configuração de um determinado escopo.

Estrutura

git config [escopo] --unset chave

Em que:

• [escopo] (opcional): define o escopo da remoção.

• --unset: indica que a configuração deve ser removida.

• chave: se refere ao nome da configuração que será apagada. Exemplos: user.name, user.email.

Exemplos de uso

• Remove a configuração user.name do escopo padrão

  • git config --unset user.name

• Remove a configuração user.name apenas do repositório atual

  • git config --local --unset user.name

• Remove a configuração user.name do escopo global

  • git config --global --unset user.name

• Remove a configuração user.name do escopo system.

  • git config --system --unset user.name

Após remover uma configuração, o Git passa a considerar o valor definido em um escopo mais amplo, caso ele exista.

---

Com isso, você já conhece os principais usos do comando git config, como o Git organiza suas configurações em diferentes escopos e como esses valores são armazenados e lidos internamente.

A seguir, vamos ver um exemplo completo de como essas configurações aparecem no dia a dia e por que elas são necessárias logo nos primeiros passos ao trabalhar com Git.

Esta é uma explicação simplificada para fins didáticos. Para explorar todas as possibilidades do comando gitconfig, consulte a documentação oficial.