Se você trabalha com diferentes usuários em projetos pessoais e de trabalho, é interessante configurar seu username e email no Git de maneira local, por projeto, para que seja corretamente rastreado no Github, Gitlab e Bitbucket.

Por padrão o arquivo /<users>/.gitconfig é usado para armazenar as suas configurações globais de usuário e e-mail para o Git.

Conteúdo do arquivo .gitconfig

Este é um exemplo de como um arquivo de configuração .gitconfig é composto:

[user]
	name = Ademir Mazer Junior
	email = email [at] mazer.dev
[pull]
	rebase = false
[commit]
	gpgSign = false
[gui]
	pruneduringfetch = true
[smartgit "submodule"]
	fetchalways = true
	update = true
	initializenew = true
[push]
	recurseSubmodules = check

Como você pode verificar, a tag [user]é usada para que todos os clientes Git encontrem seu username e email para configurar os push e commits.

Configurando username e email por projeto no Git

O Git oferece três possibilidades de definir seu nome de usuário e e-mail. As configurações serão consideradas na seguinte ordem, onde 1 > substituirá 2 > substituirá 3.

  1. projeto – Os dados são armazenados diretamente no projeto correspondente (repositório) em git/config.
  2. global – para todos os repositórios do usuário atual. O arquivo de configuração pode ser encontrado em seu diretório home ~/.gitconfig.
  3. sistema – Esta é uma configuração de todo o sistema e está disponível para todos os usuários e todos os repositórios. Você o encontrará nos sistemas Linux, em geral, em /etc/gitconfig.

Na maioria dos casos, você definirá uma configuração global para o usuário e, na sequência, definirá as configurações específicas de cada projeto.

Vamos verificar os três níveis de configuração, do mais abrnagente (item 3 acima) para o mais específico, o item 1 – por projeto:

Configurando username e email para todo o sistema no Git

Esta não é uma indicação tão comum nos tutoriais e cursos, mas você pode configurar para todos os usuários de um sistema operacional um username e email para o Git:

$ git config --system user.name "Nome de usuário do sistema"
$ git config --system user.email "[email protected]"

Esta portanto é a configuração global para todos os usuário de seu sistema operacional.

Configurando username e email globalmente no Git

Relembrando os comandos de configuração mais difundidos ao instalar Git:

$ git config --global user.name "Meu nome global"
$ git config --global user.email "[email protected]"

Esta é a configuração global para seu usuário de sistema operacional.

Configurando username e email no Git para um projeto específico

Por fim, esta opção sobrepõe as configurações anteriores, para cada projeto em que ela for utilizada. Similarmente às demais opções, você usara os comandos git config, dentro do diretório de seu projeto, porém, desta vez, sem utilizar o parâmetro global ou system:

# lembre-se de navegar para o raiz do projeto
$ cd pasto-do-projeto
$ git config user.name "Meu nome neste projeto"
$ git config user.email "[email protected]"

Você também pode usar a opção --local para “garantir” a configuração local.

Verificando as configurações de nome de usuário e email

Para verificar como estão as configurações utilize o comando git config com a opção --get:

$ git config --get user.name
$ git config --get user.email

Os comandos acima mostrarão as configurações locais, para verificar globalmente ou no sistema, adicione as opções --global ou --system.

Artigos de referência:

Mantenha-se atualizado

Não esqueça de me seguir no Twitter e assinar o Canal Mazer.dev no Youtube para receber atualizações de novos artigos, vídeo aulas e cursos gratuitos em desenvolvimento e engenharia de software.

Mais sobre Git, Github e Gitlab

Commit
Git commits semânticos

Commits semânticos no uso de Git e outros VCS (sistemas de versionamento de código), são a melhor forma de documentação de execução de implementa&cce…

Conexão lenta git
Como corrigir GIT lento com SSH no Github, Gitlab ou Bitbucket

Para corrigir comandos GIT de push e pull lentos, quando estamos usando chaves ssh nos serviços de repositórios Github, Gitlab e Bitbucket, é necessário alterar a config…

Erro
Como resolver o erro fatal refusing to merge unrelated histories

O erro fatal refusing to merge unrelated histories é lançado ao tentar fazer o merge automático de projetos que possuem históricos Git diferentes. Desde o Release 2…

Professor ensinando controle de versão
Como configurar username e email por projeto com Git

Se você trabalha com diferentes usuários em projetos pessoais e de trabalho, é interessante configurar seu username e email no Git de maneira local, por projeto, para que seja c…

Instalar o Git
Instalando Git no Windows, Linux e MacOS

O sistema de versionamento de software Git não vem instalado por padrão nos sistemas operacionais Linux, Windows e MacOS. Mesmo se ele já tiver sido instalado, é uma boa…

Infográfico Brasil
Repositórios de dados abertos para programadores

Awesome Data Table References é um repositório de minha responsabilidade, onde faço curadoria de referências para tabelas de dados abertos de instituições e…

1 comentário em “Como configurar username e email por projeto com Git”

  1. Pingback: GIT - Cache temporário de credenciais - MAZER.DEV

Deixe um comentário

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *