Gerador de .gitignore

Monte um .gitignore combinando modelos selecionados para 13 linguagens, 7 frameworks, macOS/Windows/Linux e IDEs populares. Duplicados são removidos automaticamente.

.gitignore

O que é Gerador de .gitignore?

Um arquivo .gitignore diz ao Git quais arquivos deixar fora do controle de versão, como dependências, saídas de build, logs, segredos e configurações de editores. Marque as linguagens, frameworks, sistemas operacionais e editores que o seu projeto usa e a ferramenta combina modelos selecionados em um único .gitignore limpo, removendo padrões duplicados.

Como usar Gerador de .gitignore

  1. Marque os modelos de que precisa em Linguagens, Frameworks, Sistemas operacionais e Editores e IDEs (use Filtrar modelos para encontrar um).
  2. Acrescente linhas específicas do projeto em Padrões extras.
  3. Copie o resultado ou baixe-o como .gitignore e coloque-o na raiz do repositório.

Exemplo

Entrada
Node.js + macOS
Saída
# ===== Node.js =====
# Dependencies
node_modules/
jspm_packages/
…
# Environment
.env
.env.*
!.env.example

# ===== macOS =====
.DS_Store
.AppleDouble
.LSOverride
._*
.Spotlight-V100
.Trashes

Quando usar Gerador de .gitignore

Use-o ao iniciar um repositório ou ao adicionar uma nova ferramenta ao projeto. Observe que o .gitignore só afeta arquivos não rastreados: se um arquivo já foi commitado, remova-o do índice antes com git rm --cached <file>. Faça commit do próprio .gitignore para que toda a equipe o compartilhe; se preferir, coloque arquivos pessoais de editor no seu gitignore global.

Como funciona Gerador de .gitignore

Os modelos são selecionados da conhecida coleção github/gitignore e enxugados ao essencial. Eles são concatenados em uma ordem fixa (linguagens → frameworks → SO → editores), cada um sob um cabeçalho # ===== Name =====. Um padrão que já apareceu em um modelo anterior é pulado, cabeçalhos de comentário que ficam sem padrões são descartados e os padrões extras que você acrescentar entram em uma seção Custom, se ainda não existirem.

Casos de Uso Comuns

  • Iniciar um novo repositório Node.js, Python ou Java
  • Manter arquivos .env e segredos fora do Git
  • Ignorar lixo do sistema como .DS_Store e Thumbs.db
  • Combinar regras de um monorepo com várias stacks

Perguntas Frequentes

Por que um arquivo continua rastreado depois que o adicionei ao .gitignore?

O Git só ignora arquivos não rastreados. Execute git rm --cached <file> (ou -r para pastas), faça commit, e a partir daí ele será ignorado.

O que significa o prefixo !?

Ele inclui de volta um arquivo que um padrão anterior ignorou; por exemplo, !.env.example mantém o arquivo env de exemplo enquanto .env.* ignora os demais.

Devo ignorar pastas de editor como .vscode?

O modelo do VS Code ignora o estado pessoal, mas mantém configurações compartilhadas, tasks, configurações de launch e extensões recomendadas.

Explore mais categorias