Comandos Essenciais do Git

Q: Qual a diferença entre git add . e git add file.tsx?

git add . faz o staging de todas as alterações no diretório atual e subdiretórios git add file.tsx faz o staging apenas desse arquivo específico Prefira fazer o staging de arquivos específicos para evitar commitar acidentalmente alterações indesejadas (por exemplo, arquivos .env)

Q: Quando devo usar git switch em vez de git checkout?

git switch foi introduzido no Git 2.23+ para clarificar a intenção de troca de branch git checkout é sobrecarregado: ele troca branches E restaura arquivos Use git switch para branches, git restore para arquivos, se sua versão do Git os suportar

Q: Como desfaço o último commit mas mantenho minhas alterações?

--soft mantém as alterações em staging --mixed (padrão) mantém as alterações mas as desfaz o staging --hard descarta as alterações completamente (perigoso)

Q: O que são prefixos de commit convencionais e por que usá-los?

Prefixes como feat:, fix:, refactor:, docs:, chore:, test: categorizam as alterações Eles permitem a geração automática de changelogs e versionamento semântico Equipes podem escanear rapidamente o histórico para entender o que cada commit faz

Q: Armadilha: Por que git add -p às vezes pula arquivos novos completamente?

git add -p só funciona em arquivos rastreados (arquivos já conhecidos pelo Git) Novos arquivos não rastreados devem primeiro ser adicionados ao staging com git add file.tsx, então você pode usar -p em alterações subsequentes

Q: Como deletar um branch local que já foi mesclado?

-d deleta apenas se o branch foi mesclado -D força a deleção mesmo de branches não mesclados (use com cautela)

Q: Como procurar por palavras-chave em mensagens de commit?

--grep filtra pelo conteúdo da mensagem de commit Adicione --all para procurar em todos os branches

Os comandos do dia a dia que todo desenvolvedor usa - staging, commit, branching e inspeção de histórico.

Receita

Cartão de referência rápida - pronto para copiar e colar.

# Initialize a new repo
git init
 
# Check current status
git status
 
# Stage specific files
git add file1.tsx file2.tsx
 
# Stage all changes
git add .
 
# Commit with message
git commit -m "feat: add user profile component"
 
# View commit history
git log --oneline --graph
 
# Create and switch to a new branch
git checkout -b feature/new-component
 
# Switch to existing branch
git checkout main
# or (modern)
git switch main

Quando usar isso: Toda vez que você escreve código. Estes comandos são a base de todos os fluxos de trabalho do Git.

Exemplo de Trabalho

# Typical feature development workflow
git checkout -b feature/auth-page
# ... write code ...
git status
git add src/app/auth/page.tsx src/app/auth/layout.tsx
git commit -m "feat: add authentication page with login form"
git push -u origin feature/auth-page

O que isso demonstra:

Cria um branch de recurso a partir do seu branch atual
Faz o staging apenas dos arquivos que você pretende commitar (evite git add . sempre que possível)
Escreve uma mensagem de commit descritiva com um prefixo convencional
Envia e define o branch de rastreamento upstream em um único comando

Mergulho Profundo

Área de Staging (Índice)

A área de staging é o passo intermediário exclusivo do Git entre seu diretório de trabalho e o repositório.

# Stage specific files
git add src/components/Button.tsx
 
# Stage parts of a file (interactive hunk selection)
git add -p src/components/Button.tsx
 
# Unstage a file (keep changes in working directory)
git restore --staged src/components/Button.tsx
 
# Discard changes in working directory
git restore src/components/Button.tsx

Melhores Práticas de Commit

# Conventional commit prefixes
git commit -m "feat: add dark mode toggle"
git commit -m "fix: resolve hydration mismatch in sidebar"
git commit -m "refactor: extract shared form validation logic"
git commit -m "docs: update API route documentation"
git commit -m "chore: upgrade next to 15.1.0"
git commit -m "test: add integration tests for checkout flow"
 
# Multi-line commit message
git commit -m "feat: add user dashboard
 
- Add profile summary card
- Add recent activity feed
- Add quick action buttons"

Inspeção de Histórico

# Compact log with graph
git log --oneline --graph --all
 
# Show changes in a specific commit
git show abc1234
 
# Show who last modified each line
git blame src/app/layout.tsx
 
# Search commit messages
git log --grep="auth" --oneline
 
# Show commits that changed a specific file
git log --oneline -- src/app/auth/page.tsx
 
# Show diff between branches
git diff main..feature/auth-page

Branching

# List all branches (local)
git branch
 
# List all branches (including remote)
git branch -a
 
# Create a branch without switching
git branch feature/sidebar
 
# Delete a merged branch
git branch -d feature/sidebar
 
# Delete an unmerged branch (force)
git branch -D feature/abandoned
 
# Rename current branch
git branch -m new-name

Armadilhas

Coisas que vão te morder. Cada armadilha inclui o que dá errado, por que acontece e a correção.

Committing no branch errado - Você escreve código no main em vez de um branch de recurso. Correção: git stash, depois git checkout -b feature/branch-correto, depois git stash pop.
Esquecer de dar pull antes de push - O push é rejeitado porque o remoto tem novos commits. Correção: git pull --rebase para reaplicar seus commits no topo das últimas alterações remotas.
Adicionar segredos acidentalmente ao staging - Arquivos .env ou credenciais são adicionados ao staging. Correção: git restore --staged .env antes de commitar. Adicione .env ao .gitignore imediatamente.
Estado de Detached HEAD - Você fez checkout de um hash de commit em vez de um nome de branch. Correção: git checkout -b meu-branch para criar um branch nesse commit, ou git checkout main para voltar.
Arquivos grandes inchando o repositório - Commitar node_modules ou artefatos de build. Correção: Adicione-os ao .gitignore antes do primeiro commit. Se já foi committado, use git rm -r --cached node_modules.

Alternativas

Outras maneiras de resolver o mesmo problema - e quando cada uma é a melhor escolha.

Alternativa	Use Quando	Não Use Quando
`git switch` / `git restore`	Git moderno (2.23+) - intenção mais clara que `checkout`	Versões mais antigas do Git ou memória muscular
`git stash`	Troca rápida de contexto sem commitar trabalho em andamento	Você quer um registro permanente do estado do trabalho em andamento
`git worktree`	Trabalhar em dois branches simultaneamente	Fluxos de trabalho simples de um único branch

FAQs

Qual a diferença entre `git add .` e `git add file.tsx`?

git add . faz o staging de todas as alterações no diretório atual e subdiretórios
git add file.tsx faz o staging apenas desse arquivo específico
Prefira fazer o staging de arquivos específicos para evitar commitar acidentalmente alterações indesejadas (por exemplo, arquivos .env)

Quando devo usar `git switch` em vez de `git checkout`?

git switch foi introduzido no Git 2.23+ para clarificar a intenção de troca de branch
git checkout é sobrecarregado: ele troca branches E restaura arquivos
Use git switch para branches, git restore para arquivos, se sua versão do Git os suportar

Como desfaço o último commit mas mantenho minhas alterações?

git reset --soft HEAD~1

--soft mantém as alterações em staging
--mixed (padrão) mantém as alterações mas as desfaz o staging
--hard descarta as alterações completamente (perigoso)

O que são prefixos de commit convencionais e por que usá-los?

Prefixes como feat:, fix:, refactor:, docs:, chore:, test: categorizam as alterações
Eles permitem a geração automática de changelogs e versionamento semântico
Equipes podem escanear rapidamente o histórico para entender o que cada commit faz

Como vejo o que mudou em um commit específico?

git show abc1234

Mostra a mensagem de commit, autor, data e o diff completo
Adicione --stat para um resumo dos arquivos alterados em vez do diff completo

O que acontece se eu commitar acidentalmente segredos como `.env`?

O segredo agora está no histórico do Git mesmo se você deletar o arquivo em um novo commit
Rotacione imediatamente as credenciais expostas
Use git filter-branch ou git filter-repo para remover o arquivo do histórico
Adicione .env ao .gitignore para prevenir acidentes futuros

Armadilha: Por que `git add -p` às vezes pula arquivos novos completamente?

git add -p só funciona em arquivos rastreados (arquivos já conhecidos pelo Git)
Novos arquivos não rastreados devem primeiro ser adicionados ao staging com git add file.tsx, então você pode usar -p em alterações subsequentes

Como deletar um branch local que já foi mesclado?

git branch -d feature/my-branch

-d deleta apenas se o branch foi mesclado
-D força a deleção mesmo de branches não mesclados (use com cautela)

O que significa detached HEAD e como corrigi-lo?

Detached HEAD significa que você fez checkout de um hash de commit em vez de um nome de branch
Quaisquer novos commits que você fizer não estarão em nenhum branch e podem ser perdidos
Correção: git checkout -b meu-novo-branch para criar um branch no commit atual

Como procurar por palavras-chave em mensagens de commit?

git log --grep="auth" --oneline

--grep filtra pelo conteúdo da mensagem de commit
Adicione --all para procurar em todos os branches

Em um projeto TypeScript, devo commitar `tsconfig.tsbuildinfo`?

Não. É um arquivo de cache de build gerado pela compilação incremental do TypeScript
Adicione *.tsbuildinfo ao seu .gitignore

Como posso verificar os tipos de arquivos TypeScript em staging antes de commitar?

npx tsc --noEmit

Combine isso com um hook de pré-commit (por exemplo, Husky + lint-staged) para automatizar
--noEmit verifica tipos sem produzir arquivos de saída

Relacionados

Merging & Rebasing - Combinando branches e mantendo o histórico limpo
GitHub CLI - Crie PRs e gerencie issues do terminal
Git Utilities - Stash, bisect, cherry-pick e outras ferramentas poderosas

Receita

Cartão de referência rápida - pronto para copiar e colar.

# Initialize a new repo
git init
 
# Check current status
git status
 
# Stage specific files
git add file1.tsx file2.tsx
 
# Stage all changes
git add .
 
# Commit with message
git commit -m "feat: add user profile component"
 
# View commit history
git log --oneline --graph
 
# Create and switch to a new branch
git checkout -b feature/new-component
 
# Switch to existing branch
git checkout main
# or (modern)
git switch main

Quando usar isso: Toda vez que você escreve código. Estes comandos são a base de todos os fluxos de trabalho do Git.

Exemplo de Trabalho

# Typical feature development workflow
git checkout -b feature/auth-page
# ... write code ...
git status
git add src/app/auth/page.tsx src/app/auth/layout.tsx
git commit -m "feat: add authentication page with login form"
git push -u origin feature/auth-page

O que isso demonstra:

Cria um branch de recurso a partir do seu branch atual
Faz o staging apenas dos arquivos que você pretende commitar (evite git add . sempre que possível)
Escreve uma mensagem de commit descritiva com um prefixo convencional
Envia e define o branch de rastreamento upstream em um único comando

Mergulho Profundo

Área de Staging (Índice)

A área de staging é o passo intermediário exclusivo do Git entre seu diretório de trabalho e o repositório.

# Stage specific files
git add src/components/Button.tsx
 
# Stage parts of a file (interactive hunk selection)
git add -p src/components/Button.tsx
 
# Unstage a file (keep changes in working directory)
git restore --staged src/components/Button.tsx
 
# Discard changes in working directory
git restore src/components/Button.tsx

Melhores Práticas de Commit

# Conventional commit prefixes
git commit -m "feat: add dark mode toggle"
git commit -m "fix: resolve hydration mismatch in sidebar"
git commit -m "refactor: extract shared form validation logic"
git commit -m "docs: update API route documentation"
git commit -m "chore: upgrade next to 15.1.0"
git commit -m "test: add integration tests for checkout flow"
 
# Multi-line commit message
git commit -m "feat: add user dashboard
 
- Add profile summary card
- Add recent activity feed
- Add quick action buttons"

Inspeção de Histórico

# Compact log with graph
git log --oneline --graph --all
 
# Show changes in a specific commit
git show abc1234
 
# Show who last modified each line
git blame src/app/layout.tsx
 
# Search commit messages
git log --grep="auth" --oneline
 
# Show commits that changed a specific file
git log --oneline -- src/app/auth/page.tsx
 
# Show diff between branches
git diff main..feature/auth-page

Branching

# List all branches (local)
git branch
 
# List all branches (including remote)
git branch -a
 
# Create a branch without switching
git branch feature/sidebar
 
# Delete a merged branch
git branch -d feature/sidebar
 
# Delete an unmerged branch (force)
git branch -D feature/abandoned
 
# Rename current branch
git branch -m new-name

Armadilhas

Coisas que vão te morder. Cada armadilha inclui o que dá errado, por que acontece e a correção.

Committing no branch errado - Você escreve código no main em vez de um branch de recurso. Correção: git stash, depois git checkout -b feature/branch-correto, depois git stash pop.
Esquecer de dar pull antes de push - O push é rejeitado porque o remoto tem novos commits. Correção: git pull --rebase para reaplicar seus commits no topo das últimas alterações remotas.
Adicionar segredos acidentalmente ao staging - Arquivos .env ou credenciais são adicionados ao staging. Correção: git restore --staged .env antes de commitar. Adicione .env ao .gitignore imediatamente.
Estado de Detached HEAD - Você fez checkout de um hash de commit em vez de um nome de branch. Correção: git checkout -b meu-branch para criar um branch nesse commit, ou git checkout main para voltar.
Arquivos grandes inchando o repositório - Commitar node_modules ou artefatos de build. Correção: Adicione-os ao .gitignore antes do primeiro commit. Se já foi committado, use git rm -r --cached node_modules.

Alternativas

Outras maneiras de resolver o mesmo problema - e quando cada uma é a melhor escolha.

Alternativa	Use Quando	Não Use Quando
`git switch` / `git restore`	Git moderno (2.23+) - intenção mais clara que `checkout`	Versões mais antigas do Git ou memória muscular
`git stash`	Troca rápida de contexto sem commitar trabalho em andamento	Você quer um registro permanente do estado do trabalho em andamento
`git worktree`	Trabalhar em dois branches simultaneamente	Fluxos de trabalho simples de um único branch

FAQs

Qual a diferença entre `git add .` e `git add file.tsx`?

git add . faz o staging de todas as alterações no diretório atual e subdiretórios
git add file.tsx faz o staging apenas desse arquivo específico
Prefira fazer o staging de arquivos específicos para evitar commitar acidentalmente alterações indesejadas (por exemplo, arquivos .env)

Quando devo usar `git switch` em vez de `git checkout`?

git switch foi introduzido no Git 2.23+ para clarificar a intenção de troca de branch
git checkout é sobrecarregado: ele troca branches E restaura arquivos
Use git switch para branches, git restore para arquivos, se sua versão do Git os suportar

Como desfaço o último commit mas mantenho minhas alterações?

git reset --soft HEAD~1

--soft mantém as alterações em staging
--mixed (padrão) mantém as alterações mas as desfaz o staging
--hard descarta as alterações completamente (perigoso)

O que são prefixos de commit convencionais e por que usá-los?

Prefixes como feat:, fix:, refactor:, docs:, chore:, test: categorizam as alterações
Eles permitem a geração automática de changelogs e versionamento semântico
Equipes podem escanear rapidamente o histórico para entender o que cada commit faz

Como vejo o que mudou em um commit específico?

git show abc1234

Mostra a mensagem de commit, autor, data e o diff completo
Adicione --stat para um resumo dos arquivos alterados em vez do diff completo

O que acontece se eu commitar acidentalmente segredos como `.env`?

O segredo agora está no histórico do Git mesmo se você deletar o arquivo em um novo commit
Rotacione imediatamente as credenciais expostas
Use git filter-branch ou git filter-repo para remover o arquivo do histórico
Adicione .env ao .gitignore para prevenir acidentes futuros

Armadilha: Por que `git add -p` às vezes pula arquivos novos completamente?

git add -p só funciona em arquivos rastreados (arquivos já conhecidos pelo Git)
Novos arquivos não rastreados devem primeiro ser adicionados ao staging com git add file.tsx, então você pode usar -p em alterações subsequentes

Como deletar um branch local que já foi mesclado?

git branch -d feature/my-branch

-d deleta apenas se o branch foi mesclado
-D força a deleção mesmo de branches não mesclados (use com cautela)

O que significa detached HEAD e como corrigi-lo?

Detached HEAD significa que você fez checkout de um hash de commit em vez de um nome de branch
Quaisquer novos commits que você fizer não estarão em nenhum branch e podem ser perdidos
Correção: git checkout -b meu-novo-branch para criar um branch no commit atual

Como procurar por palavras-chave em mensagens de commit?

git log --grep="auth" --oneline

--grep filtra pelo conteúdo da mensagem de commit
Adicione --all para procurar em todos os branches

Em um projeto TypeScript, devo commitar `tsconfig.tsbuildinfo`?

Não. É um arquivo de cache de build gerado pela compilação incremental do TypeScript
Adicione *.tsbuildinfo ao seu .gitignore

Como posso verificar os tipos de arquivos TypeScript em staging antes de commitar?

npx tsc --noEmit

Combine isso com um hook de pré-commit (por exemplo, Husky + lint-staged) para automatizar
--noEmit verifica tipos sem produzir arquivos de saída

Relacionados

Merging & Rebasing - Combinando branches e mantendo o histórico limpo
GitHub CLI - Crie PRs e gerencie issues do terminal
Git Utilities - Stash, bisect, cherry-pick e outras ferramentas poderosas

Comandos Essenciais do Git

Buscar na documentação

Comandos Essenciais do Git