Guia prático

.gitignore Generator — Guia de uso e princípios técnicos

Gere rapidamente arquivos .gitignore com templates para múltiplas linguagens de programação e frameworks

Abrir ferramenta

Visão geral

Um arquivo .gitignore é um arquivo de texto que informa ao Git quais arquivos ou diretórios ignorar em um projeto. Ele evita que arquivos desnecessários como saídas de compilação, pastas de dependências (node_modules), configurações de IDE, arquivos temporários e dados sensíveis sejam rastreados no controle de versão. Este arquivo usa correspondência de padrões para especificar regras de exclusão, mantendo seu repositório limpo e prevenindo commits acidentais de arquivos que não deveriam ser compartilhados ou versionados.

Conceitos principais

O que é .gitignore

.gitignore é um arquivo de configuração do Git que especifica quais arquivos e diretórios devem ser ignorados pelo controle de versão. Ele usa correspondência de padrões para excluir artefatos de construir, dependências, arquivos temporários, dados sensíveis e outros arquivos que não devem ser rastreados. Cada linha no arquivo representa um padrão de ignorar, suportando curingas (*), separadores de diretório (/) e operadores de negação (!).

Regras de Correspondência de Padrões

Git usa padrões glob para correspondência de arquivos. Asterisco (*) corresponde a quaisquer caracteres exceto barra, asterisco duplo (**) corresponde a quaisquer diretórios recursivamente, ponto de interrogação (?) corresponde a caractere único, colchetes ([]) correspondem a conjuntos de caracteres. Padrões terminando com barra (/) correspondem apenas a diretórios, padrões começando com barra correspondem da raiz do repositório, e ponto de exclamação (!) nega padrões.

Melhores Práticas

Sempre ignore saídas de construir (dist/, construir/), dependências (node_modules/, vendor/), arquivos IDE (.vscode/, .idea/), arquivos OS (.DS_Store, Thumbs.db), arquivos de ambiente (.env) e arquivos de registro (*.registro). Use padrões específicos em vez de curingas amplos para evitar ignorar acidentalmente arquivos importantes. Faça commit do .gitignore cedo no ciclo de vida do projeto.

Otimização de Desempenho

.gitignore configurado adequadamente reduz tamanho do repositório, acelera operações Git e previne commit de arquivos binários grandes ou código gerado. Melhora desempenho de clone, reduz custos de armazenamento e mantém repositório focado em código-fonte. Coloque padrões mais específicos primeiro para melhor desempenho de correspondência.

Recursos

Biblioteca Rica de Templates

Mais de 50 templates comuns integrados cobrindo Node.js, Python, Java, React, Vue, .NET e outras stacks tecnológicas mainstream

Combinação Inteligente

Templates multi-selecionados mesclam e deduplicam automaticamente, combinam inteligentemente regras de linguagem, framework e editor

Regras Personalizadas

Suporte para adicionar padrões de ignorar personalizados, configuração flexível para atender necessidades específicas do projeto

Exportação Rápida

Copie para área de transferência com um clique ou baixe como arquivo .gitignore, aplique instantaneamente ao seu projeto

Perguntas frequentes

O que é um arquivo .gitignore e por que preciso dele?

Um arquivo .gitignore informa ao Git quais arquivos e diretórios ignorar ao rastrear alterações em seu repositório. Ele impede o commit acidental de artefatos de construir, dependências, arquivos temporários, dados sensíveis, configurações IDE e arquivos específicos do sistema operacional. Isso mantém seu repositório limpo, reduz o tamanho do repositório, melhora o desempenho do Git e protege informações sensíveis do versionamento.

Como uso vários modelos juntos?

Você pode selecionar vários modelos (por exemplo, Node.js + React + VS Code) e o gerador os mesclará automaticamente, removendo padrões duplicados. Os modelos são combinados inteligentemente: modelos de idioma fornecem regras base, modelos de framework adicionam exclusões específicas do framework, e modelos de editor adicionam arquivos específicos do IDE. O .gitignore final contém todos os padrões únicos de seus modelos selecionados.

Posso adicionar padrões de ignorar personalizados?

Sim, você pode adicionar padrões de ignorar personalizados na seção Regras personalizadas. Digite um padrão por linha, usando a mesma sintaxe de padrão glob dos arquivos .gitignore. Exemplos incluem: *.registro (ignorar todos os arquivos de registro), node_modules/ (ignorar o diretório node_modules), .env (ignorar arquivos de ambiente) ou dist/ (ignorar saída de construir). Os padrões personalizados são adicionados ao conteúdo do modelo gerado.

Quais padrões devo incluir no meu .gitignore?

Padrões comuns para incluir: saídas de construir (dist/, construir/, target/), dependências (node_modules/, vendor/, .venv/), arquivos IDE (.vscode/, .idea/, *.swp), arquivos OS (.DS_Store, Thumbs.db), arquivos de ambiente (.env, .env.local), logs (*.registro, logs/), e arquivos temporários (*.tmp, *.cache). Os modelos do gerador incluem esses padrões comuns para sua pilha tecnológica selecionada.

Como aplico o .gitignore gerado ao meu projeto?

Após gerar seu .gitignore, você pode copiar o conteúdo para a área de transferência e colá-lo em um novo arquivo .gitignore na raiz do seu projeto, ou baixá-lo diretamente. Se você já tem um arquivo .gitignore, pode mesclar os padrões manualmente. Após adicionar o arquivo, o Git ignorará automaticamente os arquivos especificados. Nota: .gitignore afeta apenas arquivos não rastreados; para ignorar arquivos já rastreados, você precisa removê-los do índice do Git primeiro.

Documentos Relacionados

.gitignore Generator

Abra a ferramenta para experimentar estes recursos.

Abrir ferramenta