Git e GitHub: Guia Completo

Aprenda o fluxo completo de versionamento e como utilizar Fork para entregas.

1. Git vs GitHub

Git é um sistema de controle de versão local.

GitHub é uma plataforma online para hospedar repositórios.

Importante: Git funciona sem internet. GitHub precisa de conexão.

2. Configuração Inicial

Configurar usuário

git config --global user.name "Seu Nome"
git config --global user.email "seu@email.com"

O que faz: Define seu nome e email para identificar seus commits.

Por que é importante: Sem isso, o Git não consegue registrar corretamente quem fez as alterações.

3. Fluxo Básico do Git

Inicializar repositório

git init

O que faz: Cria um repositório Git na pasta atual.

Por que usar: Permite começar a controlar versões do projeto.

Adicionar arquivos

git add .

O que faz: Prepara todos os arquivos modificados para o commit.

Por que usar: O Git só salva mudanças que foram adicionadas explicitamente.

Criar commit

git commit -m "primeiro commit"

O que faz: Salva um “snapshot” do projeto.

Por que usar: Permite registrar versões e voltar no tempo se necessário.

Conectar ao GitHub

git remote add origin URL_DO_REPOSITORIO

O que faz: Liga o repositório local ao remoto no GitHub.

Por que usar: Permite enviar seu código para a internet.

Enviar arquivos

git push -u origin main

O que faz: Envia os commits para o GitHub.

Por que usar: Compartilha seu projeto e salva uma cópia online.

4. Entregas usando Fork

Esse é o fluxo recomendado para atividades!

Passo 1: Fazer Fork

O que faz: Cria uma cópia do repositório da disciplina na sua conta.

Por que usar: Permite trabalhar sem alterar o original.

Passo 2: Clonar o repositório

git clone URL_DO_SEU_FORK

O que faz: Baixa o projeto para seu computador.

Por que usar: Permite editar os arquivos localmente.

Passo 3: Criar branch

git checkout -b minha-atividade

O que faz: Cria uma nova linha de desenvolvimento.

Por que usar: Mantém o projeto organizado e evita conflitos.

Passo 4: Fazer alterações

git add .
git commit -m "resolução da atividade"

O que faz: Salva suas mudanças.

Por que usar: Garante registro do progresso da atividade.

Passo 5: Enviar alterações

git push origin minha-atividade

O que faz: Envia sua branch para o GitHub.

Por que usar: Permite criar o Pull Request.

Passo 6: Criar Pull Request

O que faz: Solicita que suas alterações sejam analisadas.

Por que usar: É a forma oficial de entrega da atividade.

O Pull Request é a forma de entregar sua atividade para correção.

5. Comandos Úteis

  • git status → Mostra arquivos modificados (evita erros antes do commit)
  • git log → Mostra histórico de commits
  • git pull → Atualiza o projeto com mudanças remotas
  • git restore . → Descarta alterações não salvas

6. Erros Comuns

❌ Esquecer de usar git add

nothing to commit, working tree clean

Problema: Você fez alterações, mas não adicionou os arquivos.

Solução:

git add .
git commit -m "mensagem"

❌ Commit sem mensagem

Problema: Mensagens vagas ou inexistentes.

Solução: Use mensagens claras:

git commit -m "corrige erro no formulário"

❌ Erro ao dar push (repositório divergente)

rejected - non-fast-forward

Problema: O repositório remoto tem alterações que você não tem.

Solução:

git pull origin main
git push origin main

❌ Trabalhando na branch errada

Problema: Alterações feitas na branch principal sem querer.

Solução:

git checkout -b nova-branch

Ou verifique antes:

git branch

❌ Conflito de merge

Problema: Duas pessoas editaram o mesmo trecho.

Solução:

  • Abrir o arquivo com conflito
  • Escolher qual versão manter
  • Salvar e executar:
git add .
git commit -m "resolve conflito"
Dica importante: erros são parte do aprendizado no Git. Sempre leia a mensagem exibida no terminal.
Dica: use git status sempre antes de executar um commit.

Vídeo: Introdução ao GitHub