🚀 Git na Prática: Aprendendo Git e GitHub 🚀

Este repositório reúne materiais de apoio para aprender sobre controle de versão com Git e o uso do GitHub.
O conteúdo foi elaborado para estudantes e iniciantes que querem compreender desde a origem do Git até o uso prático dos principais comandos.

---

📜 Tabela de Conteúdos

1. O Problema: Por que Precisamos Versionar Código?
2. A Solução: O que é Controle de Versão?
3. A Ferramenta: Git
   • Um Pouco de História
   • O que é Git, Afinal?
   • A Filosofia do Git
4. A Plataforma: GitHub (e Similares)
   • Git vs. GitHub: A Dúvida Clássica
5. Mão na Massa: Instalação e Configuração
   • Passo 1: Instalação
   • Passo 2: Verificação
   • Passo 3: Configuração Inicial
6. Seus Primeiros Passos com Git (O Fluxo Essencial)
   • Os 3 Estágios do Git
   • Passo a Passo Prático
7. Conectando seu Código ao Mundo com o GitHub
8. Dicas e Boas Práticas
9. Tabela de Comandos do Git

---

1. O Problema: Por que Precisamos Versionar Código?

Imagine que você está trabalhando em um projeto importante. Você salva o arquivo como projeto_v1.js. No dia seguinte, faz alterações e salva como projeto_v2.js. Uma semana depois, você tem uma pasta cheia de arquivos como:

• projeto_final.js
• projeto_final_agora_vai.js
• projeto_final_revisado_pelo_chefe.js
• projeto_versao_antiga_que_funcionava.js

Essa abordagem, além de confusa, traz problemas sérios:

• Perda de Histórico: Você não sabe o que mudou entre as versões.
• Falta de Segurança: Se você apagar uma versão "antiga que funcionava", pode ter perdido a solução para um bug.
• Dificuldade de Colaboração: Como duas pessoas podem trabalhar no mesmo arquivo projeto_final.js ao mesmo tempo sem sobrescrever o trabalho uma da outra?

É para resolver exatamente esses problemas que o controle de versão foi criado.

2. A Solução: O que é Controle de Versão?

Um Sistema de Controle de Versão (VCS - Version Control System) é um software que rastreia e gerencia todas as alterações feitas em arquivos ao longo do tempo. Ele permite que você:

✅ Tenha um Histórico Completo: Registra quem fez cada alteração, quando fez e por quê.

✅ Volte no Tempo: Se uma nova funcionalidade quebrar o projeto, você pode reverter para uma versão anterior estável com um único comando. É uma verdadeira máquina do tempo para o seu código.

✅ Colabore de Forma Eficiente: Permite que várias pessoas trabalhem no mesmo projeto de forma organizada, unindo as alterações de todos no final.

✅ Experimente com Segurança: Você pode criar "ramificações" (branches) para testar novas ideias sem medo de estragar a versão principal do projeto.

3. A Ferramenta: Git

Um Pouco de História

O Git foi criado em 2005 por Linus Torvalds, o mesmo criador do Kernel do Linux. A equipe que desenvolvia o Linux precisava de um VCS que fosse extremamente rápido, eficiente e que suportasse o trabalho de milhares de desenvolvedores espalhados pelo mundo (desenvolvimento distribuído). Como nenhuma ferramenta da época atendia a esses requisitos, Linus decidiu criar a sua própria. E assim nasceu o Git.

O que é Git, Afinal?

Git é o software de controle de versão mais popular do mundo. Ele é um Sistema de Controle de Versão Distribuído.

Isso significa que, em vez de um único servidor central com todo o histórico, cada desenvolvedor que "clona" um projeto tem em sua máquina uma cópia completa de todo o histórico do projeto. Isso torna a maioria das operações (como visualizar o histórico ou criar branches) incrivelmente rápidas.

A Filosofia do Git

• Velocidade: Quase todas as operações são locais, o que o torna muito rápido.
• Simplicidade: Possui um design simples, embora sua curva de aprendizado possa ser desafiadora no início.
• Segurança: Todos os objetos no Git são "checados" por um algoritmo (SHA-1), garantindo a integridade do seu código e histórico.
• Desenvolvimento Não-Linear: O Git foi feito para ramificar e mesclar (branch e merge), tornando o trabalho paralelo e a experimentação algo natural.

4. A Plataforma: GitHub (e Similares)

Git vs. GitHub: A Dúvida Clássica

É crucial entender a diferença:

• Git é a ferramenta, o software que você instala na sua máquina para versionar código.
• GitHub é uma plataforma online, um serviço que hospeda repositórios Git na nuvem.

💡 Analogia Simples: Pense no Git como o Microsoft Word (o software que você usa para escrever um texto) e no GitHub como o Google Docs (a plataforma online onde você salva seus textos, compartilha e colabora com outras pessoas).

Existem outras plataformas similares ao GitHub, como o GitLab e o Bitbucket.

5. Mão na Massa: Instalação e Configuração

Passo 1: Instalação

• 💻 Windows: Baixe e instale o Git for Windows. Ele vem com o terminal Git Bash, que é recomendado.
• 🍎 macOS: A forma mais fácil é via Homebrew (brew install git). Se não tiver o Homebrew, o macOS pedirá para instalar as "Command Line Developer Tools" na primeira vez que você tentar usar o git no terminal, o que já inclui o Git.
• 🐧 Linux (Debian/Ubuntu):

  sudo apt-get update
  sudo apt-get install git
  

Passo 2: Verificação

Abra seu terminal (ou Git Bash no Windows) e digite:

git --version

Se a instalação correu bem, você verá a versão do Git instalada.

Passo 3: Configuração Inicial

O Git precisa saber quem você é para "assinar" suas alterações. Configure seu nome e e-mail. Isso é feito apenas uma vez por computador.

git config --global user.name "Seu Nome Completo"
git config --global user.email "seuemail@exemplo.com"

💡 Dica de Ouro: Por padrão, o Git costumava criar a branch principal com o nome master. A comunidade de desenvolvimento adotou main como o novo padrão. Você pode configurar seu Git para sempre iniciar com main:

git config --global init.defaultBranch main

6. Seus Primeiros Passos com Git (O Fluxo Essencial)

Os 3 Estágios do Git

Para entender o Git, pense que seus arquivos podem estar em três "lugares":

1. Working Directory: A pasta do seu projeto, onde você efetivamente edita os arquivos.
2. Staging Area (Index): Uma área de preparação. É aqui que você agrupa as alterações que farão parte do seu próximo "ponto de salvamento" (commit).
3. Repository (.git): A "caixa-preta" onde o Git armazena permanentemente todo o histórico de commits.

Passo a Passo Prático

1. Crie e Inicie um Repositório

   mkdir meu-projeto
   cd meu-projeto
   git init
   

2. Verifique o Status

   git status
   

3. Crie um Arquivo e Adicione à Staging Area

   git add index.html
   git add .
   

4. Faça seu Primeiro Commit

   git commit -m "Adiciona a estrutura inicial do index.html"
   

5. Visualize o Histórico

   git log
   git log --oneline
   

Parabéns! Você acabou de completar o fluxo de trabalho básico e local do Git!

7. Conectando seu Código ao Mundo com o GitHub

1. Crie um Repositório no GitHub
2. Conecte seu Repositório Local ao Remoto:

   git remote add origin https://github.com/seu-usuario/meu-projeto.git
   

3. Envie seu Código (Push):

   git push -u origin main
   

8. Dicas e Boas Práticas

• Commits Atômicos: Faça commits pequenos e focados.
• Boas Mensagens de Commit: Use o imperativo.
• .gitignore: Liste arquivos e pastas que o Git deve ignorar.
• git status: Use constantemente para se orientar.
• Faça pull antes de push para evitar conflitos.

---

9. Tabela de Comandos do Git

🧩 Comandos Essenciais

Comando	Descrição	Exemplo
git init	Cria um repositório Git.	git init
git clone	Clona um repositório remoto.	git clone https://github.com/usuario/repositorio.git
git status	Mostra o status atual do repositório.	git status
git add	Adiciona arquivos à área de preparação.	git add arquivo.txt
git commit	Salva as mudanças no histórico.	git commit -m "Mensagem"
git log	Mostra o histórico de commits.	git log --oneline
git diff	Mostra as diferenças entre versões.	git diff
git push	Envia as alterações para o remoto.	git push origin main
git pull	Atualiza o repositório local.	git pull origin main
git branch	Gerencia branches.	git branch / git branch nova
git checkout	Alterna entre branches.	git checkout main
git merge	Junta alterações de branches.	git merge nova-feature

---

⚙️ Comandos Avançados

Comando	Descrição	Exemplo
git stash	Guarda temporariamente alterações.	git stash / git stash pop
git revert	Desfaz um commit específico.	git revert <hash>
git reset	Restaura o repositório a um estado anterior.	git reset --hard <hash>
git reflog	Mostra histórico completo, incluindo commits “perdidos”.	git reflog
git cherry-pick	Aplica um commit específico em outra branch.	git cherry-pick <hash>
git rebase	Reorganiza o histórico de commits.	git rebase main
git tag	Cria marcações de versão.	git tag v1.0.0
git blame	Mostra quem alterou cada linha.	git blame arquivo.txt
git bisect	Localiza o commit que introduziu um bug.	git bisect start
git log --graph	Exibe histórico em forma de gráfico.	git log --oneline --graph --decorate --all

💡 Use git help <comando> para acessar a documentação oficial.

---

🧠 Dica Extra

Todas essas funcionalidades podem ser utilizadas de maneira ainda mais fácil com editores de código modernos como:

• Visual Studio Code
• Zed
• Sublime Text
• JetBrains IDEs (PyCharm, IntelliJ, etc.)

Esses editores integram o Git visualmente — permitindo realizar commits, criar branches, resolver conflitos e enviar alterações para o GitHub com apenas alguns cliques.

Vídeo exemplificando como utilizar o Git no VSCode, feito pelo canal Thiago Veigah:

---

🌍 Feliz codificação e que seus commits sejam sempre claros!

🤝 Contribuições

Sinta-se à vontade para abrir issues ou enviar pull requests com sugestões de melhorias e novos conteúdos.