Git para iniciantes: guia completo de versionamento

Git é o sistema de controle de versão mais adotado no desenvolvimento de software. Com ele, você registra cada alteração no código, pode voltar a versões anteriores e colaborar sem sobrescrever o trabalho de ninguém. Este guia cobre o fluxo básico para iniciantes: instalação, comandos essenciais e um erro comum a evitar em cada etapa.

Pré-requisitos

• Um terminal (Prompt de Comando no Windows, Terminal no macOS/Linux)
• Git instalado (baixe em git-scm.com)
• Um editor de texto (VS Code, Sublime Text ou similar)

Passo 1: Configurar o Git

Antes de usar, configure seu nome de usuário e email. Eles ficam associados a cada commit.

git config --global user.name "Seu Nome" git config --global user.email "[email protected]"

Erro comum: esquecer de configurar. O Git exibe uma mensagem de erro ao tentar fazer o primeiro commit.

Passo 2: Criar um repositório local

Um repositório é a pasta onde o Git monitora as alterações.

mkdir meu-projeto cd meu-projeto git init

Dica: o comando git init cria uma subpasta oculta .git. Não a delete nem edite manualmente.

Passo 3: Adicionar arquivos à área de preparação (staging)

Crie um arquivo index.html e adicione ao staging:

git add index.html

ou para adicionar todos os arquivos:

git add .

Erro comum: usar git add . sem verificar o que será adicionado. Execute git status antes para revisar as mudanças.

Passo 4: Fazer o primeiro commit

O commit salva uma versão do seu trabalho.

git commit -m "Primeiro commit: estrutura inicial"

Dica: escreva mensagens de commit claras e no imperativo. Evite mensagens genéricas como "alterações" ou "update".

Passo 5: Conectar a um repositório remoto (GitHub)

Crie um repositório no GitHub (sem README.gitignore ou licença) e copie a URL.

git remote add origin https://github.com/seu-usuario/meu-projeto.git git branch -M main git push -u origin main

Erro comum: tentar fazer push sem configurar o remote. O Git retorna "fatal: 'origin' does not appear to be a git repository".

Passo 6: Fluxo diário (add, commit, push)

A partir daqui, o ciclo se repete:

1. Edite os arquivos
2. git add . (prepare as mudanças)
3. git commit -m "mensagem" (salve a versão)
4. git push (envie para o GitHub)

Dica: execute git pull antes de começar a trabalhar se estiver em time, para evitar conflitos.

Checklist do que foi feito

• [ ] Git instalado e configurado
• [ ] Repositório local criado com git init
• [ ] Arquivos adicionados ao staging com git add
• [ ] Versão salva com git commit
• [ ] Repositório remoto configurado e primeiro git push realizado
• [ ] Fluxo de trabalho diário compreendido

Perguntas frequentes sobre Git para iniciantes

Qual a diferença entre git add e git commit?

git add move as alterações para a área de preparação (staging), como uma lista de itens a serem empacotados. git commit empacota esses itens em uma versão permanente no histórico.

O que significa staging area?

É uma área intermediária entre o diretório de trabalho e o repositório. Você decide quais alterações entram no próximo commit. Isso permite commits atômicos e organizados.

Como desfazer um commit?

Use git revert HEAD para criar um novo commit que desfaz as alterações do último commit. Não use git reset em repositórios compartilhados, pois ele reescreve o histórico.

Preciso usar GitHub para usar Git?

Não. Git funciona localmente. GitHub é um serviço de hospedagem remota que facilita o compartilhamento e a colaboração, mas não é obrigatório.

O que é um conflito de merge?

Ocorre quando duas pessoas alteram a mesma linha de um arquivo de formas diferentes. O Git pausa o merge e pede que você resolva manualmente qual versão manter.

Como ver o histórico de commits?

Use git log. Ele exibe cada commit com hash, autor, data e mensagem. Para uma visualização mais enxuta, use git log --oneline.