Instalando Git e configuração inicial: nome, email e editor

Git é uma ferramenta essencial para o controle de versão de projetos de software. Antes de começar a utilizar seus comandos poderosos, é necessário instalar o Git corretamente e realizar uma configuração inicial que definirá sua identidade como desenvolvedor. Este artigo aborda desde a instalação nos principais sistemas operacionais até as configurações fundamentais de nome, email e editor de texto.

1. Instalação do Git nos principais sistemas operacionais

Windows

A instalação no Windows é feita através do instalador oficial disponível em https://git-scm.com/download/win. Durante o processo, algumas opções merecem atenção:

  • Seleção de componentes: mantenha marcado "Git Bash Here" e "Git GUI Here" para facilitar o acesso.
  • Editor padrão: você pode escolher o editor que será usado pelo Git (recomenda-se escolher "Use Visual Studio Code as Git's default editor" se tiver o VS Code instalado).
  • Ajuste do PATH: escolha "Git from the command line and also from 3rd-party software" para usar Git no terminal comum.
  • Conversão de linha: selecione "Checkout Windows-style, commit Unix-style line endings" para evitar problemas de formatação.

macOS

No macOS, existem duas formas principais de instalação:

Usando Homebrew:

brew install git

Usando o instalador oficial:
Baixe o instalador .dmg em https://git-scm.com/download/mac e execute-o normalmente.

Linux

Para distribuições baseadas em Debian ou Ubuntu:

sudo apt update
sudo apt install git

Para Fedora:

sudo dnf install git

Para Arch Linux:

sudo pacman -S git

2. Verificando a instalação e primeiros passos

Após a instalação, confirme que o Git foi instalado corretamente:

git --version

A saída será algo como:

git version 2.43.0

No Windows, você pode usar o Git Bash, que emula um terminal Unix e oferece uma experiência mais completa. No macOS e Linux, utilize o terminal nativo do sistema.

Para acessar o manual integrado de qualquer comando Git:

git help <comando>

Por exemplo:

git help config

3. Configuração global: definindo nome de usuário

O nome de usuário é essencial porque ele fica registrado como autor de cada commit. Para configurá-lo globalmente (aplicável a todos os repositórios do seu usuário):

git config --global user.name "Seu Nome Completo"

Exemplo prático:

git config --global user.name "Maria Silva"

Para verificar a configuração atual:

git config --global user.name

Saída esperada:

Maria Silva

4. Configuração global: definindo e-mail

O e-mail configurado no Git é associado a cada commit e é utilizado por serviços como GitHub, GitLab e Bitbucket para vincular commits à sua conta. Configure-o com:

git config --global user.email "seu@email.com"

Exemplo:

git config --global user.email "maria.silva@exemplo.com"

Para verificar:

git config --global user.email

Importante: Use o mesmo e-mail que você utiliza no GitHub/GitLab para que seus commits sejam corretamente atribuídos à sua conta.

5. Configuração do editor de texto padrão

O editor padrão é usado quando o Git precisa abrir um arquivo de texto para edição (por exemplo, ao escrever mensagens de commit ou resolver conflitos). Configure-o com:

git config --global core.editor "comando-do-editor"

Exemplos práticos para editores comuns:

Visual Studio Code:

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

Nano:

git config --global core.editor "nano"

Vim:

git config --global core.editor "vim"

Sublime Text:

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

Para testar se a configuração funcionou, utilize:

git config --global --edit

Esse comando abrirá o arquivo de configuração global no editor que você definiu.

6. Níveis de configuração: global, system e local

O Git possui três níveis de configuração, que determinam o escopo de cada definição:

Global (--global)

Aplica-se a todos os repositórios do usuário atual. É o nível mais comum para configurações pessoais como nome, email e editor.

git config --global user.name "Maria Silva"

System (--system)

Aplica-se a todos os usuários da máquina. Requer privilégios de administrador.

sudo git config --system core.editor "nano"

Local (sem flag)

Aplica-se apenas ao repositório atual. Útil para configurações específicas de projeto.

git config user.name "Maria Silva (Projeto X)"

A precedência é: local > global > system. Ou seja, configurações locais sobrescrevem as globais, que por sua vez sobrescrevem as de sistema.

7. Listando e removendo configurações

Para exibir todas as configurações ativas e suas origens:

git config --list

Para filtrar por escopo:

git config --list --global

Para remover uma configuração específica:

git config --unset --global user.name

Exemplo de remoção de configuração local:

git config --unset user.email

Você também pode editar diretamente os arquivos de configuração:
- Global: ~/.gitconfig
- System: /etc/gitconfig
- Local: .git/config (dentro do repositório)

Conclusão

Com o Git instalado e configurado corretamente, você está pronto para iniciar seu trabalho com controle de versão. As configurações de nome, email e editor são fundamentais para garantir que seus commits sejam devidamente identificados e que você tenha uma experiência produtiva ao utilizar comandos que exigem edição de texto. Lembre-se de que essas configurações podem ser ajustadas a qualquer momento e em diferentes escopos conforme a necessidade do seu fluxo de trabalho.

Referências