Guia Prático

Git Workflow & Cheat Sheet

// branching, commits e comandos essenciais

Guia completo de Git para o dia a dia: estratégias de branching, conventional commits, comandos mais usados e fluxos de trabalho profissionais.

Comandos Essenciais

// os comandos que você mais vai usar

Referência rápida dos comandos Git fundamentais organizados por categoria.

Básicos

git initInicializa um repositório Git no diretório atual

git clone <url>Clona um repositório remoto

git statusMostra o estado dos arquivos (modificados, staged, untracked)

git add <arquivo>Adiciona arquivo ao staging area

git add .Adiciona todos os arquivos modificados

git commit -m "msg"Cria um commit com mensagem

Branches

git branchLista branches locais

git branch <nome>Cria nova branch

git checkout <branch>Troca para outra branch

git checkout -b <nome>Cria e troca para nova branch

git branch -d <nome>Deleta branch local

git merge <branch>Merge de outra branch na atual

Remoto

git pushEnvia commits para o remoto

git push -u origin <branch>Push e define upstream da branch

git pullPuxa e faz merge das mudanças remotas

git fetchBaixa mudanças remotas sem merge

git remote -vLista repositórios remotos

Histórico

git log --onelineHistórico compacto de commits

git log --graphHistórico visual com branches

git diffMostra diferenças não staged

git diff --stagedMostra diferenças já staged

git blame <arquivo>Mostra quem alterou cada linha

Desfazer

git restore <arquivo>Descarta mudanças não staged

git restore --staged <arquivo>Remove do staging area

git reset HEAD~1Desfaz último commit mantendo mudanças

git reset --hard HEAD~1Desfaz último commit e descarta tudo

git stashSalva mudanças temporariamente

git stash popRestaura mudanças do stash

Estratégias de Branching

// organize seu fluxo de desenvolvimento

As principais estratégias de branching usadas em equipes profissionais.

Git Flow

Modelo robusto com branches dedicadas para features, releases e hotfixes. Ideal para projetos com ciclos de release definidos.

Branches:

main

develop

feature/*

release/*

hotfix/*

Vantagens

Ciclo de release organizado
Separação clara de responsabilidades
Ideal para versionamento semântico

Desvantagens

Complexidade maior
Muitas branches para gerenciar
Lento para CI/CD contínuo

Ideal para

Projetos com releases planejadas

GitHub Flow

Modelo simplificado: main + feature branches com Pull Requests. Perfeito para deploy contínuo.

Branches:

main

feature/*

Vantagens

Simples e direto
Ótimo para CI/CD
Deploy a cada merge

Desvantagens

Sem branch de staging
Pode ser limitado para releases complexas

Ideal para

SaaS e projetos com deploy contínuo

Trunk Based Development

Todo mundo commita direto na main (ou em branches muito curtas). Foco em integração contínua real.

Branches:

main

short-lived/*

Vantagens

Integração contínua real
Menos conflitos de merge
Feedback rápido

Desvantagens

Requer feature flags
Precisa de boa cobertura de testes
Disciplina da equipe

Ideal para

Equipes maduras com bom CI/CD

Conventional Commits

// mensagens de commit padronizadas

Padrão para mensagens de commit que facilita changelogs automáticos, versionamento semântico e histórico legível.

Formato:tipo(escopo?): descrição

feat

Nova funcionalidade

feat(auth): add login with Google

fix

Correção de bug

fix(cart): resolve quantity update issue

docs

Documentação

docs(readme): update installation guide

style

Formatação (sem mudança de lógica)

style(button): fix indentation

refactor

Refatoração de código

refactor(api): simplify error handling

test

Testes

test(user): add unit tests for signup

chore

Tarefas de manutenção

chore(deps): update dependencies

perf

Melhoria de performance

perf(query): optimize database queries

Dicas para boas mensagens

•Use o imperativo: "add feature" e não "added feature"
•Máximo 72 caracteres na primeira linha
•Escopo é opcional mas ajuda: feat(auth), fix(cart)
•Body para explicar o "porquê", não o "o quê"
•Breaking changes: adicione BREAKING CHANGE no footer ou ! após o tipo

Workflows Comuns

// fluxos do dia a dia

Passo a passo dos fluxos de trabalho mais comuns no Git.

Criar Feature

git checkout main

git pull origin main

git checkout -b feature/nome-da-feature

# Desenvolva e faça commits...

git push -u origin feature/nome-da-feature

# Abra um Pull Request

Resolver Conflito de Merge

git checkout feature/minha-feature

git merge main

# Resolva os conflitos nos arquivos marcados

git add .

git commit -m "fix: resolve merge conflicts"

git push

Hotfix em Produção

git checkout main

git pull origin main

git checkout -b hotfix/descricao-do-bug

# Corrija o bug

git commit -m "fix: descricao do bug"

git push -u origin hotfix/descricao-do-bug

# Abra PR para main e develop

Desfazer Último Commit (não pushed)

# Manter mudanças (unstaged)

git reset HEAD~1

# Manter mudanças (staged)

git reset --soft HEAD~1

# Descartar tudo

git reset --hard HEAD~1

Cheat Sheet Rápido

// atalhos e aliases úteis

Aliases e configurações para acelerar seu workflow no Git.

Git Aliases

git coAtalho para checkout

git config --global alias.co checkout

git brAtalho para branch

git config --global alias.br branch

git ciAtalho para commit

git config --global alias.ci commit

git stAtalho para status

git config --global alias.st status

git lgLog visual compacto

git config --global alias.lg "log --oneline --graph --all"

Comandos Úteis

git commit --amendEdita o último commit

git rebase -i HEAD~3Rebase interativo dos últimos 3 commits

git cherry-pick <hash>Aplica um commit específico na branch atual

git bisect startBusca binária para encontrar commit com bug

git reflogHistórico de todas as operações (mesmo resets)

git clean -fdRemove arquivos untracked e diretórios

Curtiu o guia?

Explore mais guias e ferramentas práticas para devs.

Voltar às Dicas

Conteúdo relacionado

Dicas de IA para DesenvolvedoresGuia prático de ferramentas IA, uso consciente de tokens e modelos: v0, Copilot, prompt engineering, boas práticas e ferramentas para produtividade dev.

Tailwind CSS + shadcn/ui — Guia PráticoSetup completo, componentes reutilizáveis, padrões de código e boas práticas com Tailwind CSS e shadcn/ui para projetos React e Next.js.

React Query Essencial — Cache e MutationsGuia completo de TanStack Query (React Query): cache inteligente, mutations, invalidação, otimistic updates e boas práticas para apps React.

10 min de leitura