Git versionamento codigo: guia passo a passo para iniciantes

Se você já perdeu uma versão funcional do código ou precisou voltar atrás em uma alteração sem saber como, o Git resolve isso. Ele cria um histórico completo de cada modificação, permitindo que você volte no tempo, trabalhe em equipe sem conflitos e mantenha tudo organizado. Antes de começar, tenha o Git instalado (git --version confirma) e um repositório criado no GitHub, GitLab ou Bitbucket.

Passo 1: Inicializar o repositório local

No terminal, navegue até a pasta do seu projeto e execute git init. Isso cria uma pasta oculta .git que guarda todo o histórico. Erro comum: esquecer de iniciar o repositório e tentar commitar, o Git avisará que não é um repositório Git. Dica: use git status para ver o estado atual e confirmar que o repositório foi criado.

Passo 2: Adicionar arquivos ao controle de versão

Com git add . você prepara todos os arquivos modificados para o próximo commit. Se quiser adicionar apenas um arquivo específico, use git add nome_do_arquivo.ext. Erro comum: adicionar arquivos sensíveis (como senhas) ou desnecessários (como node_modules). Dica: crie um arquivo .gitignore antes do primeiro add para excluir pastas que não devem ser versionadas.

Passo 3: Criar o primeiro commit

Execute git commit -m "mensagem descritiva". O commit salva um ponto no histórico com a mensagem explicando o que mudou. Erro comum: mensagens genéricas como "atualização" ou "commit". Dica: escreva mensagens no imperativo (ex.: "Adiciona validação de email") e mantenha cada commit focado em uma única alteração. Use git log para ver o histórico.

Passo 4: Conectar ao repositório remoto

No GitHub, crie um repositório vazio (sem README). Copie a URL SSH ou HTTPS. No terminal, execute git remote add origin URL. Depois, git branch -M main renomeia a branch principal para main. Erro comum: tentar push sem adicionar o remote, o Git rejeitará. Dica: verifique com git remote -v se a origem está correta.

Passo 5: Enviar as alterações para o remoto

Com git push -u origin main, você envia o commit local para o GitHub. O -u define que a branch local main acompanha a remota, evitando repetir o comando nos próximos pushes, depois, basta git push. Erro comum: conflitos se alguém alterou o repositório remoto antes. Dica: sempre faça git pull antes de push quando trabalhar em equipe.

Checklist rápido do que você fez

• [ ] Inicializou o repositório com git init
• [ ] Adicionou arquivos com git add
• [ ] Criou um commit com git commit -m
• [ ] Conectou ao remoto com git remote add
• [ ] Enviou as alterações com git push

Perguntas frequentes (FAQ)

Qual comando para ver a versão do Git?

Use git --version no terminal. Ele retorna algo como "git version 2.43.0". Se não reconhecer o comando, o Git não está instalado ou não está no PATH.

Como fazer versionamento de código sem Git?

Sem Git, você pode usar outros sistemas como SVN ou Mercurial, mas o Git é o padrão da indústria. Alternativas manuais (copiar pastas) são propensas a erro e não recomendadas.

Como atualizar a versão do Git?

No Linux, use sudo apt update && sudo apt upgrade git. No Windows, baixe o instalador mais recente do site oficial. No macOS, com Homebrew: brew upgrade git.

Como versionar código no GitHub?

Crie um repositório no GitHub, clone localmente com git clone URL, faça alterações, adicione com git add, commit e push. O GitHub hospeda o repositório remoto e oferece interface web.

Posso desfazer um commit?

Sim. Se ainda não fez push, use git reset --soft HEAD~1 para desfazer o último commit mantendo as alterações nos arquivos. Se já fez push, prefira git revert HEAD.

O que é branch no Git?

Branch é uma linha independente de desenvolvimento. A padrão é main. Você cria branches para trabalhar em funcionalidades sem afetar o código principal. Use git branch nome para criar e git checkout nome para alternar.