Se você já perdeu uma versão funcional de um código ou sobrescreveu o trabalho de outra pessoa, sabe o caos que isso gera. O versionamento de código resolve isso: é um sistema que registra cada alteração feita nos arquivos, permitindo voltar no tempo, comparar versões e colaborar sem sobrescrever o trabalho alheio. Neste guia, você vai aprender o essencial para começar, com Git, a ferramenta mais usada do mercado.
Passo 1: Instalar o Git e configurar seu nome
O Git é o motor do versionamento. Instale-o pelo site oficial (git-scm.com) ou via gerenciador de pacotes. No terminal, configure sua identidade:
git config --global user.name "Seu Nome" git config --global user.email "[email protected]"
Dica: Use o mesmo e-mail do GitHub para associar os commits à sua conta. Erro comum: pular essa etapa e depois ter commits sem autor identificado.
Passo 2: Criar um repositório local
Um repositório é a pasta que o Git vai monitorar. Dentro da pasta do seu projeto, execute:
git init
Isso cria uma subpasta .git com todo o histórico. Para ver o status dos arquivos, use git status.
Dica: Crie um arquivo .gitignore antes do primeiro commit para excluir pastas como node_modules ou .env. Erro comum: versionar arquivos desnecessários, poluindo o histórico.
Passo 3: Fazer o primeiro commit
Commit é um instantâneo do projeto naquele momento. Adicione os arquivos ao palco (stage) e salve:
git add . git commit -m "Primeiro commit: estrutura inicial"
Dica: Escreva mensagens de commit claras e no imperativo ("Adiciona função de login", não "adicionei"). Erro comum: commits muito grandes, que dificultam localizar problemas depois.
Passo 4: Criar e usar branches
Branches são linhas paralelas de desenvolvimento. A branch padrão é main. Crie uma nova para testar algo:
git branch minha-feature git checkout minha-feature
Ou, de uma vez: git checkout -b minha-feature. Faça commits normalmente. Para voltar à main: git checkout main.
Dica: Nomeie branches com propósito claro: fix/corrige-botao, feature/adiciona-pagamento. Erro comum: trabalhar direto na main sem isolar alterações.
Passo 5: Conectar ao GitHub e enviar o código
O GitHub é um serviço remoto para hospedar repositórios. Crie um repositório vazio lá (sem README). No terminal:
git remote add origin https://github.com/seu-usuario/nome-do-repo.git git branch -M main git push -u origin main
Dica: Use git pull antes de git push se houver alterações remotas. Erro comum: esquecer de dar pull e enfrentar conflitos.
Checklist do que você aprendeu
- [ ] Git instalado e configurado
- [ ] Repositório local criado com
git init - [ ] Primeiro commit feito com mensagem clara
- [ ] Branch criada para isolar alterações
- [ ] Código enviado ao GitHub com
git push
Perguntas Frequentes
O que é versionamento de código?
É um sistema que registra cada alteração em arquivos ao longo do tempo. Permite voltar a versões anteriores, comparar mudanças e colaborar sem sobrescrever o trabalho dos outros.
Git e GitHub são a mesma coisa?
Não. Git é a ferramenta de versionamento local. GitHub é uma plataforma online que hospeda repositórios Git e oferece funcionalidades extras como pull requests e issues.
Preciso saber linha de comando para usar Git?
Sim, o terminal é o jeito mais direto. Mas existem interfaces gráficas como GitKraken e o próprio GitHub Desktop que facilitam o começo.
O que acontece se eu esquecer de fazer commit?
As alterações ficam apenas no diretório de trabalho. Sem commit, não há histórico. O Git não salva automaticamente, você precisa commitar manualmente.
Como resolver um conflito no Git?
Ao fazer merge, se duas pessoas alteraram a mesma linha, o Git pausa. Abra o arquivo, resolva as diferenças (as marcas <<<<<<<, =======, >>>>>>>), remova as marcas e faça um novo commit.
Posso versionar arquivos grandes?
Git não foi feito para arquivos binários grandes (vídeos, imagens pesadas). Para isso, use Git LFS (Large File Storage). Em projetos comuns, mantenha arquivos abaixo de 50 MB.
