MÓDULO 3.2 / 6 DE 8
Git e GitHub sem perder trabalho
Salvar uma versão, inspecionar diferenças e recuperar uma mudança de treino.
1Git é o histórico do projeto
O que é
Git registra versões de arquivos. Repositório é a pasta acompanhada por esse histórico; commit é um registro com alterações e mensagem. GitHub é um serviço que hospeda repositórios remotos. Você pode usar Git localmente sem publicar nada na internet.
Por que aprender
Quando um agente altera muitos arquivos, o histórico permite entender o que mudou e recuperar uma versão conhecida. Git não substitui backup de tudo: arquivos ignorados, bancos e dados externos precisam de proteção própria.
Conceitos-chave
Repositório; commit; histórico; remoto; backup.
Na prática
Uma gestora muda o modelo de relatório e perde uma seção. Um commit anterior preserva o conteúdo antigo; uma mensagem clara ajuda a localizar a mudança.
✓ Faça
Execute git --version. Na pasta de treino, use git init -b main. Não inicialize o histórico na sua pasta pessoal inteira.
✗ Evite
Aceitar uma conclusão sem conferir a entrada que a sustenta.
2Observe antes de preparar
O que é
git status mostra arquivos novos, modificados e preparados. git diff mostra mudanças ainda não preparadas; git diff --cached mostra o que vai para o próximo commit. A área de preparação, chamada staging, permite escolher exatamente quais arquivos pertencem à mesma mudança.
Por que aprender
git add . prepara tudo que não está ignorado. Para aprender, prefira nomear arquivos: você percebe melhor o escopo e reduz o risco de incluir material sem relação.
Conceitos-chave
Working tree; staging; diff; revisão de conteúdo.
Na prática
Você mudou README.md e criou uma anotação privada. git add README.md prepara somente a documentação. Antes do commit, git diff --cached confirma o que será registrado.
3Salve uma versão com intenção
O que é
Configure user.name e user.email localmente para identificar autoria. Prepare os arquivos desejados e use git commit -m com uma descrição concreta. Um commit deve representar uma mudança que você consegue explicar e verificar.
Por que aprender
Mensagens como “update” tornam o histórico pouco útil. Uma versão só é um ponto confiável se você sabe se ela funcionava e quais verificações foram feitas.
Conceitos-chave
Autoria; mensagem; mudança coesa; verificação.
Na prática
“Adiciona instruções para conferir vendas” diz o que mudou. Depois, git log --oneline mostra uma lista compacta dos registros e seus identificadores.
Sequência para experimentar
- Prepare uma cópia de treino.
- Configure git config user.name "Seu Nome" e git config user.email "seu-email" no treino. Prepare README.md e .gitignore e crie o primeiro commit.
- Registre o resultado observado e a próxima correção.
4Clone e atualize com cuidado
O que é
git clone copia um repositório remoto e seu histórico. git pull busca e integra mudanças na branch atual. Antes de atualizar, confira git status. Em um fluxo inicial, git pull --ff-only aceita somente uma atualização direta e para quando os históricos divergiram.
Por que aprender
Atualizar uma pasta com mudanças locais pode gerar conflitos. O bloqueio do --ff-only é informação útil: não o contorne apagando trabalho. Inspecione o histórico ou peça ajuda com o contexto.
Conceitos-chave
Clone cria a pasta; pull atualiza; branch é uma linha de trabalho; divergência pede revisão.
Na prática
Você clonou um projeto ontem e hoje há novas instruções no GitHub. Sem mudanças locais, --ff-only costuma avançar a versão. Com commits diferentes dos dois lados, pare e inspecione.
✓ Faça
Clone o repositório público deste curso em uma pasta separada. Leia antes de executar qualquer programa recebido, inclusive de repositórios conhecidos.
✗ Evite
Misturar a cópia de treino com arquivos privados ou trabalho em produção.
5Recupere sem apagar o histórico
O que é
git revert cria um novo commit que desfaz uma mudança anterior. É adequado para corrigir um registro já compartilhado. git restore descarta mudanças não salvas de arquivos escolhidos; pode perder trabalho. Não ensine reset --hard como resposta automática para qualquer dificuldade.
Por que aprender
Ferramentas de recuperação têm consequências diferentes. Identifique se a mudança está só no arquivo, em commit local ou publicada antes de escolher o comando.
Conceitos-chave
Revert preserva histórico; restore descarta alterações selecionadas; recuperação exige diagnóstico.
Na prática
No treino, faça um segundo commit mudando o título do README. git revert HEAD cria um terceiro commit que restaura o título anterior, sem esconder que a mudança ocorreu.
6Publique só o que revisou
O que é
git push envia commits ao remoto. Antes disso, verifique a conta, a URL de destino, o escopo dos arquivos e a ausência de credenciais. Repositório público fica acessível a terceiros; privado também exige controle de acesso. Publicar um site é uma etapa adicional, conforme a hospedagem.
Por que aprender
Misturar salvar e publicar leva a exposição acidental. Separe “registrar localmente”, “enviar ao GitHub” e “colocar o site no ar” na sua lista de verificação.
Conceitos-chave
origin; push; visibilidade; credenciais; publicação.
Na prática
Um README local pode conter rascunhos. O commit preserva esses rascunhos na máquina. Só envie quando tiver decidido que podem fazer parte do remoto escolhido.
Critérios para revisar sua entrega
Use esta rubrica depois do laboratório. Cada linha pede uma evidência; marcar leitura não significa que a prática foi executada.
| Critério | Evidência esperada | Se não passou |
|---|---|---|
| Escopo | A entrega corresponde ao objetivo desta aula. | Reduza a tarefa e nomeie um único resultado. |
| Entradas | Você sabe quais arquivos ou dados foram usados. | Liste as fontes e remova material sem relação. |
| Execução | O procedimento foi realizado no ambiente de treino. | Diferencie o que foi planejado do que foi feito. |
| Conferência | Um resultado foi comparado com uma referência. | Abra o arquivo ou repita a consulta verificável. |
| Segredos | Nenhum token, senha ou dado privado foi compartilhado. | Revise a cópia de trabalho antes de qualquer envio. |
| Continuidade | Outra pessoa consegue encontrar o próximo passo. | Atualize README e registre uma pendência concreta. |
MÃO NA MASSA / ~15 MIN OU EM ETAPAS
Seu primeiro ponto de recuperação
Use arquivos fictícios e uma pasta de treino. As práticas com instalação, Telegram ou VPS podem exigir tempo adicional para cadastro e configuração.
Git · somente na pasta de treino
Leia o bloco antes de usar. Campos como Seu Nome e usuario@ip-da-vps são exemplos para adaptar; comandos administrativos pertencem somente ao seu ambiente de treino.
git init -b main
git config user.name "Seu Nome"
git config user.email "seu-email"
git status
git add README.md .gitignore
git diff --cached
git commit -m "Registra estrutura inicial de treino"
git log --oneline
Critério de pronto
Salvar uma versão, inspecionar diferenças e recuperar uma mudança de treino. Registre o arquivo produzido, o teste executado e o resultado observado.
Abrir arquivos e modelos do laboratórioConfira o que ficou
git commit já envia os arquivos ao GitHub?
Ver resposta comentada
Não. Commit registra localmente; push envia ao remoto configurado.
Se sua resposta foi diferente, volte ao tópico correspondente e escreva a diferença em uma frase. A checagem não bloqueia seu estudo.
Resumo do módulo
- Repositório; commit; histórico; remoto; backup.
- Working tree; staging; diff; revisão de conteúdo.
- Autoria; mensagem; mudança coesa; verificação.
- Clone cria a pasta; pull atualiza; branch é uma linha de trabalho; divergência pede revisão.
- Revert preserva histórico; restore descarta alterações selecionadas; recuperação exige diagnóstico.
- origin; push; visibilidade; credenciais; publicação.
Consulte a fonte
Ferramentas verificadas em 20/09/2026; nomes de telas e disponibilidade podem mudar.