O Ciclo Básico: Clone, Add, Commit, Push e Pull

O Ciclo Básico: Clone, Add, Commit, Push e Pull — aula do módulo Git & GitHub na Prática, na trilha Setup Essencial & Terminal Descomplicado da formação…

Leitura de aproximadamente 5 minutos.

Módulo: Git & GitHub na Prática · Curso: Setup Essencial & Terminal Descomplicado · Formação: Formação Nível Zero: Ferramentas Essenciais e Gratuitas de IA e Código

O Ciclo Básico: Clone, Add, Commit, Push e Pull

O que você vai aprender

1. As Quatro Estações do Git

Para dominar o Git sem confusão mental, é essencial visualizar o ciclo de vida de uma alteração através de quatro estações bem delimitadas:

1. Área de Trabalho (Working Directory): É a pasta real no seu computador onde você abre arquivos, cria novos documentos, edita código ou instrui seu assistente de IA. Qualquer alteração feita aqui é considerada um "rascunho não salvo pelo Git". 2. Área de Preparação (Staging Area ou Index): É a bancada de seleção. Nem toda modificação feita na pasta precisa ir para o mesmo commit. Você usa o comando git add para colocar deliberadamente na bancada apenas os arquivos que pertencem àquela entrega lógica. 3. Repositório Local (Local Repository): Quando você executa git commit, o Git empacota todos os arquivos que estavam na Staging Area e grava um snapshot permanente e imutável no histórico do seu computador. 4. Repositório Remoto (GitHub / Cloud): É a cópia guardada nos servidores na nuvem. Você envia seus commits locais para lá através do git push, e baixa atualizações feitas por outros através do git pull.


+-------------------------------------------------------------------------------+
|                       O FLUXO DAS QUATRO ESTAÇÕES DO GIT                     |
+-------------------------------------------------------------------------------+
|                                                                               |
|   SEU COMPUTADOR (Ambiente Local)                       NUVEM (GitHub)        |
|                                                                               |
|   [Área de Trabalho] ── git add ──> [Staging Area]                           |
|   (Arquivos editados)               (Bancada de seleção)                      |
|                                             │                                 |
|                                        git commit                             |
|                                             │                                 |
|                                             ▼                                 |
|                                     [Repositório Local] ── git push ──> [Repo]|
|                                     (Histórico no HD)   <── git pull ── (Web) |
|                                                                               |
+-------------------------------------------------------------------------------+

2. O Ciclo Diário de Trabalho em 5 Passos

Todo desenvolvedor, cientista de dados ou profissional de automação repete este ciclo diariamente:

Passo 1: Atualizar o ambiente local (git pull)

Antes de começar a escrever qualquer nova linha de código, garanta que você possui a versão mais recente do projeto baixando eventuais atualizações da nuvem:


git pull origin main

Passo 2: Fazer as alterações necessárias

Crie, edite ou remova os arquivos do projeto usando seu editor de código ou terminal.

Passo 3: Inspecionar o status e preparar os arquivos (git add)

Verifique o que foi modificado e coloque as alterações na Staging Area:


git status
git add .

(O comando git add . com um ponto adiciona todos os arquivos modificados da pasta atual para a bancada de preparação).

Passo 4: Registrar a foto no histórico local (git commit)

Grave a fotografia no histórico local acompanhada de uma mensagem descritiva:


git commit -m "feat: adicionar formulario de cadastro de clientes"

Passo 5: Enviar para a nuvem (git push)

Transmita os novos commits locais para o servidor do GitHub:


git push origin main

3. Como Escrever Mensagens de Commit Profissionais

A mensagem de commit (passada após a flag -m) é o registro permanente que você e sua equipe lerão daqui a seis meses para entender por que aquela alteração foi realizada.

Evite mensagens vagas como:

Adote o padrão convencional simples (Semantic Commits):

4. Clonando um Repositório Existente (git clone)

Se você deseja baixar um projeto que já existe no GitHub para o seu computador, utilize o comando git clone seguido da URL SSH do repositório:


git clone git@github.com:usuario/nome-do-projeto.git

Esse comando cria automaticamente uma nova pasta no seu computador com todo o histórico de arquivos e já configura a conexão remota com o GitHub.

5. Armadilhas Comuns e Como Evitar

[!WARNING]
Tentar commitar sem adicionar à Staging Area: Se você modificar um arquivo e rodar diretamente git commit -m "minha mudanca", o Git responderá: no changes added to commit (use "git add" to track). Isso ocorre porque o Git exige que você declare explicitamente quais arquivos devem entrar no commit através do comando git add antes de rodar o git commit.

Exercício Prático

Pratique o ciclo completo criando e versionando seu primeiro projeto com o Git no terminal:

1. Crie uma pasta de projeto e inicialize um repositório Git local:


   mkdir -p ~/meu-primeiro-repo
   cd ~/meu-primeiro-repo
   git init

(O comando git init cria a pasta oculta .git que transforma o diretório em um repositório).

2. Crie o arquivo principal de documentação:


   echo "# Meu Primeiro Repositório Git" > README.md
   echo "Projeto criado durante a Formacao Nivel Zero da Juliano Ceconi Academy." >> README.md

3. Inspecione o estado e adicione ao stage:


   git status
   git add README.md
   git status

(Observe que o arquivo passou da cor vermelha 'Untracked' para a cor verde 'Changes to be committed').

4. Grave seu primeiro commit e consulte o histórico:


   git commit -m "docs: inicializar documentacao do projeto com README"
   git log --oneline

(O comando git log --oneline exibirá o hash resumido do seu commit e a mensagem gravada com sucesso).

Outras aulas do módulo