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.