Pular para o conteúdo principal

Controle de Versão Distribuído com Git CLI

O que é Controle de Versão?

Um sistema de controle de versão distribuído (VCS) permite registrar o histórico de alterações no código-fonte ao longo do tempo, possibilitando que múltiplos desenvolvedores trabalhem simultaneamente no mesmo projeto sem sobrescrever o trabalho alheio.

┌───────────────┐
│ main (Branch) │ ──▶ Commit A ──▶ Commit B ──▶ Commit D (Merge)
└───────────────┘ ▲

┌───────────────┐ │
│ feature/login │ ───────────────▶ Commit C ───────┘
└───────────────┘

💻 Guia Prático de Comandos Git CLI (Terminal)

1. Criando e Configurando o Repositório

# Configura nome e e-mail do autor (global)
git config --global user.name "Seu Nome"
git config --global user.email "seu.email@exemplo.com"

# Inicializa um novo repositório local
git init

2. Fluxo de Versionamento Diário

# Verifica o status dos arquivos (Staging Area)
git status

# Adiciona arquivos modificados para a Staging Area
git add .

# Registra uma foto (snapshot) do projeto com uma mensagem clara
git commit -m "feat: adiciona simulador de algoritmos de busca"

# Visualiza o histórico de commits compactado
git log --oneline --graph

3. Ramificação e Fusão (Branches & Merges)

# Cria e muda para uma nova branch de funcionalidade
git switch -c feature/nova-tela

# Lista todas as branches locais
git branch

# Retorna para a branch principal e une as alterações
git switch main
git merge feature/nova-tela

4. Integração Remota (GitHub / GitLab)

# Clona um repositório remoto existente
git clone https://github.com/usuario/repositorio.git

# Associa um repositório remoto localmente
git remote add origin https://github.com/usuario/repositorio.git

# Envia alterações locais para a nuvem
git push -u origin main

# Baixa e mescla atualizações da nuvem
git pull origin main

📝 Documentação de Repositórios em Markdown

O arquivo README.md na raiz do repositório é a porta de entrada de qualquer projeto de software:

# Nome do Projeto

## 🚀 Sobre o Projeto
Descrição clara dos objetivos e funcionalidades.

## 🛠️ Tecnologias Utilizadas
- JavaScript (Node.js)
- Git & GitHub CLI
- VS Code

## ⚡ Como Executar
```bash
npm install
npm run dev