Introdução

Antes de rastrear alterações, criar branches ou colaborar, você precisa de um repositório Git — a pasta .git onde o Git armazena o histórico completo do seu projeto. Esta seção apresenta os quatro comandos que você usa sempre que começa a trabalhar com um repositório:

• git init — transforma uma pasta comum em um repositório novo e vazio.
• git clone — copia um repositório existente (geralmente de um servidor) para a sua máquina.
• git config — define sua identidade e ajusta o comportamento do Git.
• Git aliases — cria nomes curtos e memoráveis para comandos que você digita com frequência.

Cada comando tem sua própria página dedicada; esta introdução fornece o modelo mental e uma referência rápida para que você saiba qual usar e quando. Se você ainda não instalou o Git, comece com Instalar Git.

git init

O comando git init transforma o diretório atual em um novo repositório Git vazio. Ele cria um subdiretório oculto .git contendo tudo o que o Git precisa para rastrear seu projeto — armazenamento de objetos, a área de staging (índice), refs e um HEAD padrão. Até que esse diretório exista, o Git não tem nada para rastrear.

Use git init quando estiver começando do zero ou quiser colocar um projeto local existente sob controle de versão. Nada nos seus arquivos de trabalho é alterado ou commitado automaticamente — init apenas configura a estrutura necessária.

# Start a brand-new project in the current folder
git init

# Or create the folder and initialize it in one step
git init my-project

Executar o comando em uma pasta já inicializada não causa problemas: o Git exibe Reinitialized existing Git repository e mantém seu histórico intacto.

git clone

O comando git clone cria uma cópia local de um repositório existente, incluindo todo o histórico de commits, e o configura para se comunicar com o original. É assim que a maioria dos colaboradores obtém um projeto: você clona uma vez e, a partir daí, executa pull e push.

A clonagem define automaticamente a origem como um remote chamado origin, faz checkout do branch padrão e cria branches de rastreamento remoto para que o Git saiba como são os branches do servidor.

# Clone into a folder named after the repo
git clone https://github.com/user/project.git

# Clone into a custom folder name
git clone https://github.com/user/project.git my-folder

Use clone em vez de init sempre que o projeto já existir em outro lugar — raramente você executa git init em um repositório que já existe em um servidor.

git config

O comando git config lê e grava as variáveis de configuração do Git, que controlam desde a identidade nos commits até o comportamento padrão e as cores. A configuração existe em três níveis, cada um substituindo o anterior:

• --system — aplica-se a todos os usuários da máquina.
• --global — aplica-se ao usuário atual (armazenado em ~/.gitconfig).
• --local — aplica-se apenas ao repositório atual (padrão quando nenhum nível é especificado).

A primeira coisa que todo novo usuário do Git deve fazer é definir seu nome e e-mail, pois eles são registrados em cada commit:

git config --global user.name "Your Name"
git config --global user.email "[email protected]"

Para ler um valor ou listar tudo, use:

# Read one setting
git config --global user.name

# List all effective settings and where each came from
git config --list --show-origin

git alias

Um alias do Git é um atalho que mapeia um nome curto para um comando mais longo. Não existe um comando git alias independente — os aliases são apenas entradas de configuração criadas com git config (ou editando ~/.gitconfig diretamente). Defina-os uma vez e economize digitação para sempre.

# Now "git co" runs "git checkout"
git config --global alias.co checkout

# A richer alias: a compact, graphical log
git config --global alias.lg "log --oneline --graph --all"

Após definir os aliases acima, git co main se comporta exatamente como git checkout main, e git lg exibe um grafo condensado do histórico. Consulte git alias para aliases avançados, incluindo aliases de comandos shell.

Juntando tudo

Uma configuração típica para a primeira vez é assim — configure sua identidade uma vez e, em seguida, inicie um novo repositório ou clone um existente:

# 1. One-time identity setup (do this once per machine)
git config --global user.name "Ada Lovelace"
git config --global user.email "[email protected]"

# 2a. Start a new project...
git init my-app

# 2b. ...or grab an existing one
git clone https://github.com/user/my-app.git

A partir daqui, você está pronto para preparar alterações com git add e registrá-las com git commit.

Prática