GilLabs { GilLabs }

Primeiros Passos com Git

01 Feb 2025
EN FR

Introdução

Olá! Frequentemente me vejo explicando Git do zero, então decidi escrever este pequeno guia introdutório para servir de referência. Este guia vai te ajudar a entender o básico, desde como configurar seu primeiro repositório até fazer seu primeiro commit.

Recomendo muito utilizar um repositório local de testes para experimentar cada comando. Assim, você poderá explorar livremente e perceber como cada comando altera o estado atual dos arquivos e o histórico de commits.

Configurando Seu Primeiro Repositório Git

Primeiro, vamos configurar seu repositório Git. É aqui que o histórico do seu projeto será armazenado.

Para criar um novo repositório Git, abra seu terminal, navegue até o diretório do seu projeto e execute:

git init

Esse comando configura um repositório Git dentro da pasta do seu projeto. Simples, né?

Após rodar git init, um diretório oculto chamado .git é criado. Esse diretório contém todos os metadados e objetos que o Git usa para rastrear e gerenciar o histórico do projeto.

Adicionando Arquivos ao Repositório

Agora, vamos adicionar alguns arquivos ao repositório.

Pense na área de staging como uma área temporária, onde você reúne todas as mudanças feitas que deseja que sejam futuramente salvas em um commit. Para adicionar um arquivo, use:

git add <nome_do_arquivo>

Substitua <nome_do_arquivo> pelo nome do seu arquivo. Agora, ele está na área de staging. A área de staging permite revisar e preparar as mudanças antes de confirmá-las.

Se quiser adicionar todas as mudanças no diretório atual (incluindo arquivos modificados e excluídos), use:

git add .

Para ver o que está na área de staging e quais mudanças ainda não foram adicionadas, use:

git status

Esse comando fornece um resumo do estado atual do seu projeto.

Comitando Suas Mudanças

Agora, vamos fazer um commit das mudanças. Um commit é como uma foto instantânea do seu projeto em um determinado momento.

Para fazer um commit com uma mensagem, use:

git commit -m "Sua mensagem de commit"

Certifique-se de que sua mensagem seja clara e descritiva para facilitar a identificação do commit no futuro.

Visualizando o Histórico de Commits

Ver o histórico de commits pode ser muito útil. Para visualizar o histórico de commits, use:

git log --graph --all --oneline

Esse comando mostra uma representação gráfica do histórico de commits, o que pode ser muito útil para entender a evolução do seu projeto.

Enviando Mudanças para um Repositório Remoto

Depois de fazer alguns commits, pode ser interessante compartilhar seu trabalho ou fazer um backup em um repositório remoto, como o GitHub.

Primeiro, você precisa adicionar um repositório remoto. Se estiver usando o GitHub, o comando pode ser assim:

git remote add origin https://github.com/seuusuario/seu-repositorio.git

Em seguida, envie suas mudanças:

git push origin main

Esse comando faz o upload das mudanças para o branch main do repositório remoto.

Entendendo a Mentalidade Git

Para aproveitar melhor o Git, é importante entender como ele funciona e suas principais áreas: o sistema de arquivos, a área de staging e os commits. O fluxo de trabalho no Git trata de como as mudanças passam por diferentes estágios até serem registradas no histórico do projeto.

  1. Diretório de Trabalho (Sistema de Arquivos): Quando você modifica arquivos no seu projeto, está trabalhando diretamente no sistema de arquivos. Aqui, você cria, edita e exclui arquivos. Nessa fase, as mudanças ainda não estão sendo rastreadas pelo Git.

  2. Área de Staging: Após fazer mudanças, você adiciona os arquivos modificados à área de staging usando o comando git add. Pense na área de staging como um espaço temporário onde você prepara quais mudanças serão incluídas no próximo commit. Esse passo permite controlar exatamente o que será registrado.

  3. Commit como um Nó na Árvore: Quando estiver pronto, use git commit para tirar uma “foto” das mudanças que estão na área de staging. Esse snapshot funciona como um no histórico de versões do Git, formando uma estrutura conectada. Cada commit aponta para seu antecessor, criando uma sequência de mudanças, e não apenas versões separadas. Um branch no Git é apenas um ponteiro para uma dessas sequências, e não um “container” separado. Entender esse fluxo torna muito mais fácil navegar pelo Git e aproveitar seu verdadeiro potencial.

Um erro comum ao aprender Git é pensar que os branches funcionam como pastas separadas, mas essa ideia pode ser enganosa. Em vez disso, é mais útil imaginar o Git como uma árvore de mudanças—onde cada commit é um nó e os branches são apenas ponteiros para diferentes sequências de snapshots.

Conclusão

E é isso! Você acabou de dar seus primeiros passos com o Git. Agora, já sabe como configurar um repositório, adicionar arquivos, fazer commits, enviar mudanças para um repositório remoto e entender o básico de como o Git funciona. Continue praticando esses comandos e, em breve, você dominará o Git!

Lembre-se: onde há Git, há esperança. Com ele, você pode reverter mudanças, recuperar versões antigas do seu código e até mesmo desfazer erros com facilidade. O Git permite que vários desenvolvedores trabalhem no mesmo projeto e é a melhor forma de compartilhar código com outras pessoas.

Recursos Adicionais

Seguem alguns links de documentação, blogs e ferramentas que recomendo darem uma olhada: