Configuração do Git

Q: Qual é a diferença entre a configuração Git --global, local e --system?

--global aplica-se a todos os repositórios para o usuário atual (~/.gitconfig) Local (sem flag) aplica-se apenas ao repositório atual (.git/config) --system aplica-se a todos os usuários na máquina (raramente usado) Configurações locais substituem as globais, que substituem as do sistema

Q: Por que meu .gitignore não está ignorando um arquivo que acabei de adicionar a ele?

.gitignore apenas impede que arquivos não rastreados sejam preparados Se um arquivo já está sendo rastreado (commitado), você deve parar de rastreá-lo primeiro:

Q: Como configuro aliases do Git para comandos comuns?

Em seguida, use git s, git lg, git undo como atalhos

Q: O que pull.rebase true faz e devo habilitá-lo?

Faz com que git pull execute rebase automaticamente em vez de merge Isso evita commits de merge barulhentos ao puxar atualizações em um branch de funcionalidade Recomendado para a maioria dos fluxos de trabalho; defina com git config --global pull.rebase true

Q: Armadilha: Estou usando o email errado em commits em um repositório de trabalho. Como corrijo?

Isso define o email apenas para o repositório atual (sem --global) Commits já enviados com o email errado não podem ser alterados sem reescrever o histórico

Q: Como configuro chaves SSH para o GitHub?

Gere uma chave: ssh-keygen -t ed25519 -C "voce@exemplo.com" Adicione-a ao agente: ssh-add ~/.ssh/id_ed25519 Copie a chave pública e adicione-a ao GitHub em Configurações > Chaves SSH e GPG Teste com: ssh -T git@github.com

Q: O que é rerere e quando devo habilitá-lo?

rerere significa "reuse recorded resolution" (reutilizar resolução gravada) Ele lembra como você resolveu um conflito e o aplica automaticamente na próxima vez Habilite com git config --global rerere.enabled true Especialmente útil ao fazer rebase com frequência

Q: Como configuro um hook pre-commit para executar verificações de lint e de tipo?

Emparelhe com uma configuração lint-staged em package.json para executar verificações apenas em arquivos preparados

Configure o Git para um fluxo de trabalho produtivo - identidade, aliases, padrões e padrões .gitignore para projetos Next.js.

Receita

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

# Set identity
git config --global user.name "Your Name"
git config --global user.email "you@example.com"
 
# Set default branch name
git config --global init.defaultBranch main
 
# Use rebase on pull by default
git config pull.rebase true
 
# Enable rerere (reuse recorded resolution)
git config --global rerere.enabled true
 
# Set VS Code as editor
git config --global core.editor "code --wait"
 
# View all config
git config --list --show-origin

Quando usar isso: Ao configurar uma nova máquina, integrar-se a um projeto ou otimizar operações repetitivas do Git.

Exemplo de Trabalho

`.gitignore` recomendado para Next.js

# Dependências
node_modules/
.pnp/
.pnp.js
 
# Saída de build
.next/
out/
build/
dist/
 
# Arquivos de ambiente
.env
.env.local
.env.development.local
.env.test.local
.env.production.local
 
# IDE
.vscode/settings.json
.idea/
*.swp
*.swo
.DS_Store
 
# Debug
npm-debug.log*
yarn-debug.log*
yarn-error.log*
 
# TypeScript
*.tsbuildinfo
next-env.d.ts
 
# Vercel
.vercel
 
# Testes
coverage/
playwright-report/
test-results/
 
# Diversos
*.pem
.turbo

O que isso demonstra:

Seções separadas para dependências, saída de build, segredos, arquivos de IDE e ferramentas
Arquivos .env são sempre ignorados - segredos nunca devem ser commitados
next-env.d.ts é gerado automaticamente e deve ser ignorado

Análise Detalhada

Aliases Úteis do Git

# Short status
git config --global alias.s "status -sb"
 
# Pretty log
git config --global alias.lg "log --oneline --graph --all --decorate"
 
# Undo last commit (keep changes staged)
git config --global alias.undo "reset --soft HEAD~1"
 
# Show what you did today
git config --global alias.today "log --since='midnight' --oneline --author='Your Name'"
 
# List aliases
git config --global alias.aliases "config --get-regexp ^alias"
 
# Amend without editing message
git config --global alias.amend "commit --amend --no-edit"
 
# Quick diff of staged changes
git config --global alias.staged "diff --cached"

Uso após a configuração:

git s            # short status
git lg           # pretty log graph
git undo         # undo last commit
git today        # today's commits
git amend        # amend last commit silently
git staged       # diff of staged changes

Configuração Global vs Local

# Global (applies to all repos) - stored in ~/.gitconfig
git config --global user.name "Your Name"
 
# Local (applies to this repo only) - stored in .git/config
git config user.email "work@company.com"
 
# System (applies to all users) - rarely used
git config --system core.autocrlf true
 
# Check where a config value comes from
git config --show-origin user.email

Padrões Globais Úteis

# Auto-correct typos (runs after 1 second)
git config --global help.autocorrect 10
 
# Colorize output
git config --global color.ui auto
 
# Set default merge strategy
git config --global merge.conflictstyle diff3
 
# Sign commits with GPG
git config --global commit.gpgsign true
git config --global user.signingkey YOUR_GPG_KEY_ID
 
# Cache credentials for 1 hour
git config --global credential.helper 'cache --timeout=3600'
 
# macOS keychain
git config --global credential.helper osxkeychain

Configuração de Chave SSH para GitHub

# Generate a new SSH key
ssh-keygen -t ed25519 -C "you@example.com"
 
# Start the SSH agent
eval "$(ssh-agent -s)"
 
# Add key to agent
ssh-add ~/.ssh/id_ed25519
 
# Copy public key to clipboard (macOS)
pbcopy < ~/.ssh/id_ed25519.pub
# Then add to GitHub: Settings > SSH and GPG keys > New SSH key
 
# Test the connection
ssh -T git@github.com
# "Hi username! You've successfully authenticated"

Hooks

Hooks do Git executam scripts automaticamente em pontos chave do fluxo de trabalho do Git.

# Common hooks (in .git/hooks/ or managed by Husky)
pre-commit     # Runs before each commit - lint, format, type-check
commit-msg     # Validate commit message format
pre-push       # Runs before push - run tests
post-merge     # Runs after merge - reinstall dependencies

Com Husky (recomendado para projetos em equipe):

npx husky init
 
# Add a pre-commit hook
echo "npx lint-staged" > .husky/pre-commit

Armadilhas

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

Email errado em commits - Usar um email pessoal em um repositório de trabalho (ou vice-versa). Correção: Definir configuração local por repositório: git config user.email "trabalho@empresa.com".
.gitignore não funciona em arquivos rastreados - Adicionar um arquivo ao .gitignore depois que ele já foi commitado não para de rastreá-lo. Correção: git rm --cached .env para parar de rastreá-lo, depois fazer commit.
Problemas de final de linha (CRLF/LF) - Windows e macOS/Linux usam finais de linha diferentes, causando diffs barulhentos. Correção: Adicionar um arquivo .gitattributes: * text=auto e *.tsx text eol=lf.
Hooks não executando - Hooks do Git precisam de permissões de execução. Correção: chmod +x .husky/pre-commit. Com Husky v9+, certifique-se de que o diretório .husky/ esteja configurado corretamente.

Alternativas

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

Alternativa	Usar Quando	Não Usar Quando
`.gitattributes`	Forçar finais de linha e comportamento de diff por tipo de arquivo	Projetos simples de plataforma única
Husky + lint-staged	Projetos em equipe que precisam de verificações consistentes de pre-commit	Projetos solo onde você confia em sua própria disciplina
`direnv`	Configuração de ambiente por diretório além do Git	Necessidades de configuração apenas do Git

FAQs

Qual é a diferença entre a configuração Git `--global`, local e `--system`?

--global aplica-se a todos os repositórios para o usuário atual (~/.gitconfig)
Local (sem flag) aplica-se apenas ao repositório atual (.git/config)
--system aplica-se a todos os usuários na máquina (raramente usado)
Configurações locais substituem as globais, que substituem as do sistema

Como verifico de onde vem um valor de configuração específico?

git config --show-origin user.email

Mostra o caminho do arquivo e o valor, para que você saiba se é global ou local

Por que meu `.gitignore` não está ignorando um arquivo que acabei de adicionar a ele?

.gitignore apenas impede que arquivos não rastreados sejam preparados
Se um arquivo já está sendo rastreado (commitado), você deve parar de rastreá-lo primeiro:

git rm --cached .env
git commit -m "chore: untrack .env"

Como configuro aliases do Git para comandos comuns?

git config --global alias.s "status -sb"
git config --global alias.lg "log --oneline --graph --all"
git config --global alias.undo "reset --soft HEAD~1"

Em seguida, use git s, git lg, git undo como atalhos

O que `pull.rebase true` faz e devo habilitá-lo?

Faz com que git pull execute rebase automaticamente em vez de merge
Isso evita commits de merge barulhentos ao puxar atualizações em um branch de funcionalidade
Recomendado para a maioria dos fluxos de trabalho; defina com git config --global pull.rebase true

Armadilha: Estou usando o email errado em commits em um repositório de trabalho. Como corrijo?

git config user.email "work@company.com"

Isso define o email apenas para o repositório atual (sem --global)
Commits já enviados com o email errado não podem ser alterados sem reescrever o histórico

Como configuro chaves SSH para o GitHub?

Gere uma chave: ssh-keygen -t ed25519 -C "voce@exemplo.com"
Adicione-a ao agente: ssh-add ~/.ssh/id_ed25519
Copie a chave pública e adicione-a ao GitHub em Configurações > Chaves SSH e GPG
Teste com: ssh -T git@github.com

O que é `rerere` e quando devo habilitá-lo?

rerere significa "reuse recorded resolution" (reutilizar resolução gravada)
Ele lembra como você resolveu um conflito e o aplica automaticamente na próxima vez
Habilite com git config --global rerere.enabled true
Especialmente útil ao fazer rebase com frequência

Como configuro um hook pre-commit para executar verificações de lint e de tipo?

npx husky init
echo "npx lint-staged" > .husky/pre-commit

Emparelhe com uma configuração lint-staged em package.json para executar verificações apenas em arquivos preparados

Armadilha: Meus hooks do Git não estão executando. O que devo verificar?

Certifique-se de que o arquivo do hook tenha permissões de execução: chmod +x .husky/pre-commit
Com Husky v9+, confirme se o diretório .husky/ está inicializado corretamente
Verifique se o script prepare existe em package.json: "prepare": "husky"

Em um projeto TypeScript, quais arquivos devem ir em `.gitignore`?

node_modules/, .next/, out/, dist/, build/ (dependências e saída de build)
.env, .env.local, .env.*.local (segredos)
*.tsbuildinfo, next-env.d.ts (arquivos TypeScript gerados automaticamente)
coverage/, playwright-report/ (saída de teste)

Como lidar com problemas de final de linha CRLF vs LF entre plataformas?

Adicione um arquivo .gitattributes na raiz do repositório:

* text=auto
*.tsx text eol=lf
*.ts text eol=lf

Isso normaliza os finais de linha no commit, independentemente do sistema operacional do desenvolvedor

Relacionado

Comandos Essenciais do Git - Operações básicas do Git para uso diário
Utilitários do Git - Stash, bisect, cherry-pick e outras ferramentas poderosas
CLI do GitHub - Gerencie PRs, issues e releases pelo terminal
Linting e Formatação - Configure Husky e lint-staged

Receita

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

# Set identity
git config --global user.name "Your Name"
git config --global user.email "you@example.com"
 
# Set default branch name
git config --global init.defaultBranch main
 
# Use rebase on pull by default
git config pull.rebase true
 
# Enable rerere (reuse recorded resolution)
git config --global rerere.enabled true
 
# Set VS Code as editor
git config --global core.editor "code --wait"
 
# View all config
git config --list --show-origin

Quando usar isso: Ao configurar uma nova máquina, integrar-se a um projeto ou otimizar operações repetitivas do Git.

Exemplo de Trabalho

`.gitignore` recomendado para Next.js

# Dependências
node_modules/
.pnp/
.pnp.js
 
# Saída de build
.next/
out/
build/
dist/
 
# Arquivos de ambiente
.env
.env.local
.env.development.local
.env.test.local
.env.production.local
 
# IDE
.vscode/settings.json
.idea/
*.swp
*.swo
.DS_Store
 
# Debug
npm-debug.log*
yarn-debug.log*
yarn-error.log*
 
# TypeScript
*.tsbuildinfo
next-env.d.ts
 
# Vercel
.vercel
 
# Testes
coverage/
playwright-report/
test-results/
 
# Diversos
*.pem
.turbo

O que isso demonstra:

Seções separadas para dependências, saída de build, segredos, arquivos de IDE e ferramentas
Arquivos .env são sempre ignorados - segredos nunca devem ser commitados
next-env.d.ts é gerado automaticamente e deve ser ignorado

Análise Detalhada

Aliases Úteis do Git

# Short status
git config --global alias.s "status -sb"
 
# Pretty log
git config --global alias.lg "log --oneline --graph --all --decorate"
 
# Undo last commit (keep changes staged)
git config --global alias.undo "reset --soft HEAD~1"
 
# Show what you did today
git config --global alias.today "log --since='midnight' --oneline --author='Your Name'"
 
# List aliases
git config --global alias.aliases "config --get-regexp ^alias"
 
# Amend without editing message
git config --global alias.amend "commit --amend --no-edit"
 
# Quick diff of staged changes
git config --global alias.staged "diff --cached"

Uso após a configuração:

git s            # short status
git lg           # pretty log graph
git undo         # undo last commit
git today        # today's commits
git amend        # amend last commit silently
git staged       # diff of staged changes

Configuração Global vs Local

# Global (applies to all repos) - stored in ~/.gitconfig
git config --global user.name "Your Name"
 
# Local (applies to this repo only) - stored in .git/config
git config user.email "work@company.com"
 
# System (applies to all users) - rarely used
git config --system core.autocrlf true
 
# Check where a config value comes from
git config --show-origin user.email

Padrões Globais Úteis

# Auto-correct typos (runs after 1 second)
git config --global help.autocorrect 10
 
# Colorize output
git config --global color.ui auto
 
# Set default merge strategy
git config --global merge.conflictstyle diff3
 
# Sign commits with GPG
git config --global commit.gpgsign true
git config --global user.signingkey YOUR_GPG_KEY_ID
 
# Cache credentials for 1 hour
git config --global credential.helper 'cache --timeout=3600'
 
# macOS keychain
git config --global credential.helper osxkeychain

Configuração de Chave SSH para GitHub

# Generate a new SSH key
ssh-keygen -t ed25519 -C "you@example.com"
 
# Start the SSH agent
eval "$(ssh-agent -s)"
 
# Add key to agent
ssh-add ~/.ssh/id_ed25519
 
# Copy public key to clipboard (macOS)
pbcopy < ~/.ssh/id_ed25519.pub
# Then add to GitHub: Settings > SSH and GPG keys > New SSH key
 
# Test the connection
ssh -T git@github.com
# "Hi username! You've successfully authenticated"

Hooks

Hooks do Git executam scripts automaticamente em pontos chave do fluxo de trabalho do Git.

# Common hooks (in .git/hooks/ or managed by Husky)
pre-commit     # Runs before each commit - lint, format, type-check
commit-msg     # Validate commit message format
pre-push       # Runs before push - run tests
post-merge     # Runs after merge - reinstall dependencies

Com Husky (recomendado para projetos em equipe):

npx husky init
 
# Add a pre-commit hook
echo "npx lint-staged" > .husky/pre-commit

Armadilhas

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

Email errado em commits - Usar um email pessoal em um repositório de trabalho (ou vice-versa). Correção: Definir configuração local por repositório: git config user.email "trabalho@empresa.com".
.gitignore não funciona em arquivos rastreados - Adicionar um arquivo ao .gitignore depois que ele já foi commitado não para de rastreá-lo. Correção: git rm --cached .env para parar de rastreá-lo, depois fazer commit.
Problemas de final de linha (CRLF/LF) - Windows e macOS/Linux usam finais de linha diferentes, causando diffs barulhentos. Correção: Adicionar um arquivo .gitattributes: * text=auto e *.tsx text eol=lf.
Hooks não executando - Hooks do Git precisam de permissões de execução. Correção: chmod +x .husky/pre-commit. Com Husky v9+, certifique-se de que o diretório .husky/ esteja configurado corretamente.

Alternativas

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

Alternativa	Usar Quando	Não Usar Quando
`.gitattributes`	Forçar finais de linha e comportamento de diff por tipo de arquivo	Projetos simples de plataforma única
Husky + lint-staged	Projetos em equipe que precisam de verificações consistentes de pre-commit	Projetos solo onde você confia em sua própria disciplina
`direnv`	Configuração de ambiente por diretório além do Git	Necessidades de configuração apenas do Git

FAQs

Qual é a diferença entre a configuração Git `--global`, local e `--system`?

--global aplica-se a todos os repositórios para o usuário atual (~/.gitconfig)
Local (sem flag) aplica-se apenas ao repositório atual (.git/config)
--system aplica-se a todos os usuários na máquina (raramente usado)
Configurações locais substituem as globais, que substituem as do sistema

Como verifico de onde vem um valor de configuração específico?

git config --show-origin user.email

Mostra o caminho do arquivo e o valor, para que você saiba se é global ou local

Por que meu `.gitignore` não está ignorando um arquivo que acabei de adicionar a ele?

.gitignore apenas impede que arquivos não rastreados sejam preparados
Se um arquivo já está sendo rastreado (commitado), você deve parar de rastreá-lo primeiro:

git rm --cached .env
git commit -m "chore: untrack .env"

Como configuro aliases do Git para comandos comuns?

git config --global alias.s "status -sb"
git config --global alias.lg "log --oneline --graph --all"
git config --global alias.undo "reset --soft HEAD~1"

Em seguida, use git s, git lg, git undo como atalhos

O que `pull.rebase true` faz e devo habilitá-lo?

Faz com que git pull execute rebase automaticamente em vez de merge
Isso evita commits de merge barulhentos ao puxar atualizações em um branch de funcionalidade
Recomendado para a maioria dos fluxos de trabalho; defina com git config --global pull.rebase true

Armadilha: Estou usando o email errado em commits em um repositório de trabalho. Como corrijo?

git config user.email "work@company.com"

Isso define o email apenas para o repositório atual (sem --global)
Commits já enviados com o email errado não podem ser alterados sem reescrever o histórico

Como configuro chaves SSH para o GitHub?

Gere uma chave: ssh-keygen -t ed25519 -C "voce@exemplo.com"
Adicione-a ao agente: ssh-add ~/.ssh/id_ed25519
Copie a chave pública e adicione-a ao GitHub em Configurações > Chaves SSH e GPG
Teste com: ssh -T git@github.com

O que é `rerere` e quando devo habilitá-lo?

rerere significa "reuse recorded resolution" (reutilizar resolução gravada)
Ele lembra como você resolveu um conflito e o aplica automaticamente na próxima vez
Habilite com git config --global rerere.enabled true
Especialmente útil ao fazer rebase com frequência

Como configuro um hook pre-commit para executar verificações de lint e de tipo?

npx husky init
echo "npx lint-staged" > .husky/pre-commit

Emparelhe com uma configuração lint-staged em package.json para executar verificações apenas em arquivos preparados

Armadilha: Meus hooks do Git não estão executando. O que devo verificar?

Certifique-se de que o arquivo do hook tenha permissões de execução: chmod +x .husky/pre-commit
Com Husky v9+, confirme se o diretório .husky/ está inicializado corretamente
Verifique se o script prepare existe em package.json: "prepare": "husky"

Em um projeto TypeScript, quais arquivos devem ir em `.gitignore`?

node_modules/, .next/, out/, dist/, build/ (dependências e saída de build)
.env, .env.local, .env.*.local (segredos)
*.tsbuildinfo, next-env.d.ts (arquivos TypeScript gerados automaticamente)
coverage/, playwright-report/ (saída de teste)

Como lidar com problemas de final de linha CRLF vs LF entre plataformas?

Adicione um arquivo .gitattributes na raiz do repositório:

* text=auto
*.tsx text eol=lf
*.ts text eol=lf

Isso normaliza os finais de linha no commit, independentemente do sistema operacional do desenvolvedor

Relacionado

Comandos Essenciais do Git - Operações básicas do Git para uso diário
Utilitários do Git - Stash, bisect, cherry-pick e outras ferramentas poderosas
CLI do GitHub - Gerencie PRs, issues e releases pelo terminal
Linting e Formatação - Configure Husky e lint-staged

Configuração do Git

Buscar na documentação

Configuração do Git