Este guia descreve um fluxo de trabalho comum para desenvolvimento de projetos utilizando o Git, cobrindo desde a obtenção inicial do código até as operações diárias de desenvolvimento.
Obtenção Inicial do Projeto
Para começar a trabalhar em um projeto, você precisa obtê-lo do repositório remoto.
Clonando o Repositório
Utilize o comando git clone para baixar o projeto para sua máquina local. Recomenda-se o uso do protocolo SSH para clonagem, pois a configuração é única e permanente, evitando problemas de autenticação comuns com HTTPS.
# Usando SSH (recomendado)
git clone git@servidor-remoto.com:seu-usuario/nome-do-repositorio.git
# Usando HTTPS
git clone https://servidor-remoto.com/seu-usuario/nome-do-repositorio.git
Navegando para o Diretório do Projeto
Após o clone, acesse o diretório recém-criado do projeto.
cd nome-do-diretorio-do-projeto
Execução do Projeto
Antes de iniciar o desenvolvimento, é necessário configurar o ambiente do projeto.
Instalando Dependências
Instale as bibliotecas e pacotes necessários para o funcionamento do projeto.
# Usando npm
npm install
# Usando yarn
yarn install
Iniciando o Servidor de Desenvolvimento
Suba o servidor local para visualizar e interagir com o projeto durante o desenvolvimento.
# Usando npm
npm run dev
# Usando yarn
yarn dev
Acessando o Projeto
Abra seu navegador e navegue até o endereço fornecido pelo servidor de desenvolvimento (grealmente algo como http://localhost:XXXX).
Fluxo de Desenvolvimento Diário
Este é o ciclo de operações Git que você executará regularmente.
Atualizando o Código Local
Comece sempre seu trabalho buscando as últimas alterações do repositório remoto.
git pull origin main # Ou o nome do seu branch principal
Realizando Modificações
Edite os arquivos do projeto conforme necessário em seu editor de código.
Verificando o Status das Alterações
Confira quais arquivos foram modificados.
git status
Preparando as Alterações para Commit
Adicione os arquivos modificados à área de staging.
# Adicionar todos os arquivos modificados
git add .
# Ou adicionar um arquivo específico
git add nome-do-arquivo.extensao
Registrando as Alterações Localmente
Crie um commit com uma mensagem descritiva sobre as modificações.
git commit -m "Descreva aqui as mudanças realizadas"
Enviando as Alterações para o Repositório Remoto
Compartilhe seus commits locais com o repositório remoto.
git push origin main # Ou o nome do seu branch
Comandos Essenciais - Resumo Rápido
Um resumo dos comandos Git mais utilizados no dia a dia:
# Puxa as últimas atualizações do branch principal
git pull
# --- Modifique o código aqui ---
# Adiciona todas as modificações à área de staging
git add .
# Registra as modificações localmente com uma mensagem
git commit -m "Sua mensagem descritiva"
# Envia as modificações para o repositório remoto
git push
Resolução de Problemas Comuns
| Problema | Solução |
|---|---|
Comando npm ou yarn não encontrado. |
Execute npm install ou yarn install para instalar as dependências do projeto. |
fatal: not a git repository |
Certifique-se de que você está no diretório correto do projeto, aquele que contém a pasta .git. |
failed to push |
Execute git pull primeiro para integrar as alterações remotas com as suas locais antes de tentar o push novamente. |
Please tell me who you are |
Configure seu nome de usuário e e-mail globalmente no Git: bash git config --global user.name "Seu Nome" git config --global user.email "seu.email@exemplo.com" |
| Porta do servidor de desenvolvimento em uso. | Altere a porta configurada no arquivo de configuração do servidor de desenvolvimento ou encerre o processo que está utilizando a porta. |
Fluxo de Trabalho Visual
Este diagrama ilustra o ciclo de desenvolvimento:
Início do trabalho
↓
git pull (Obter últimas atualizações)
↓
Modificar arquivos do projeto
↓
git status (Verificar alterações)
↓
git add . (Preparar alterações)
↓
git commit -m "Descrição das mudanças" (Salvar localmente)
↓
git push (Enviar para o repositório remoto)
↓
Fim do ciclo
O fluxo central a ser lembrado é: Puxar → Modificar → Salvar → Enviar.