Principais comandos do GIT - Rafaelcolombo23/documentacao-git-grupo-amigosdotonho GitHub Wiki

🧠 Principais Comandos do Git

Este tópico apresenta os comandos mais usados do Git com explicações simples, exemplos comentados e orientações úteis. Ideal para quem está iniciando com controle de versão ou quer revisar os conceitos principais.

🔍 git status — Verificar o estado atual do repositório

Este comando mostra o que está acontecendo no seu repositório:

Quais arquivos foram modificados

Quais ainda não foram adicionados ao staging

Quais estão prontos para serem enviados com commit

Em qual branch você está trabalhando

Exemplo de uso: Digite git status após fazer modificações para verificar se o Git reconheceu essas alterações.

Dica: Use esse comando antes de cada commit para garantir que está tudo certo.

➕ git add — Adicionar arquivos ao staging

Esse comando serve para preparar os arquivos que você quer incluir no próximo commit. O Git não salva automaticamente tudo o que você muda — você precisa dizer o que quer salvar com git add.

Exemplos:

Para adicionar um arquivo específico: git add index.php

Para adicionar todos os arquivos modificados: git add . (O ponto significa "todos os arquivos no diretório atual")

Dica: Adicione apenas os arquivos que fazem parte de uma mudança lógica. Isso ajuda a manter o histórico organizado.

✅ git commit — Salvar as alterações com uma mensagem

Esse comando salva, de forma definitiva, as mudanças que estavam no staging. Ele cria um “ponto de restauração” no histórico do projeto.

Exemplo: git commit -m "Corrige bug de login e melhora layout do formulário"

A flag -m permite adicionar a mensagem direto no comando.

Dica: Escreva mensagens de commit claras e específicas. Elas ajudam você (e outras pessoas) a entender o que foi feito no futuro.

📤 git push — Enviar commits para o repositório remoto

Depois de fazer commits localmente, você precisa enviá-los para o repositório remoto (como o GitHub) para que outras pessoas vejam suas alterações.

Exemplo: git push origin main Esse comando envia seus commits para a branch main do repositório remoto chamado origin.

Dica: Sempre faça push após terminar uma tarefa ou funcionalidade. Assim, seu progresso fica salvo online.

📥 git pull — Atualizar com mudanças do repositório remoto

Esse comando baixa alterações do repositório remoto e as aplica no seu repositório local. É a combinação de dois comandos: git fetch (buscar atualizações) + git merge (juntar as atualizações à sua branch atual).

Exemplo: git pull origin main Isso baixa e aplica as atualizações da branch main do repositório remoto.

Dica: Sempre use git pull antes de começar a trabalhar para evitar conflitos com o que outras pessoas já fizeram.

🔄 git clone — Clonar um repositório remoto

Esse comando cria uma cópia completa de um repositório remoto na sua máquina, incluindo todo o histórico.

Exemplo: git clone https://github.com/usuario/repositorio.git Cria uma pasta local com todos os arquivos do repositório remoto.

Dica: Use este comando quando quiser começar a trabalhar em um projeto existente hospedado no GitHub (ou outro servidor Git).

🌿 git branch — Gerenciar branches (ramificações)

As branches permitem que você trabalhe em diferentes funcionalidades ou correções sem afetar o código principal.

Exemplos:

git branch → Lista todas as branches locais.

git branch nova-feature → Cria uma nova branch chamada "nova-feature".

git branch -d ajustes → Deleta a branch local "ajustes".

Dica: Crie uma branch para cada nova funcionalidade ou correção. Isso deixa o projeto organizado e facilita a colaboração.

🚀 git checkout — Mudar de branch

Esse comando serve para alternar entre branches ou restaurar arquivos de versões anteriores.

Exemplo: git checkout develop → Muda para a branch chamada develop.

Dica nova: A partir do Git 2.23, você pode usar o comando mais direto: git switch develop → Faz a mesma coisa, de forma mais clara.

🔀 git merge — Unir branches

Esse comando junta o conteúdo de uma branch com a outra, combinando o trabalho feito separadamente.

Exemplo: Você está na branch main e quer trazer as alterações da branch ajustes. Use: git merge ajustes → Isso aplica as mudanças da branch ajustes na main.

Dica: Sempre teste o código antes de fazer merge, e resolva conflitos com atenção.