Ir para o conteúdo principal
Bethemesh

Gerador de .gitignore

Selecione os ambientes usados no projeto, adicione regras personalizadas e gere um ficheiro .gitignore limpo sem duplicados.

  • Área de transferência
  • Exportar

Integrar este widget

Personalize o resultado, verifique a pré-visualização e copie o código.

Pré-visualização

Tipo de código de integração

Código a copiar

Responsivo e redimensionado automaticamente pela Bethemesh.

Modelos a incluir

Selecione apenas as tecnologias realmente usadas pelo projeto.

Uma regra por linha. A ordem e as repetições das regras próprias são preservadas.

Ficheiro .gitignore gerado

Esta ferramenta foi útil?

Como funciona esta ferramenta?

Compõe um .gitignore para o repositório combinando modelos locais e padrões próprios. O gerador produz texto para rever e guardar no projeto; não abre o repositório nem altera o índice Git. É útil para dependências, resultados de compilação e caches. Escolhe exclusões segundo os ficheiros realmente gerados: um padrão útil noutro contexto pode ocultar um ficheiro que a tua equipa precisa de versionar.

Os modelos são reunidos pela ordem do catálogo. São removidos padrões exatamente iguais entre modelos, sem simplificar sobreposições como *.log e um caminho concreto. As regras personalizadas são acrescentadas no fim pela ordem original. As repetições são preservadas porque uma exclusão repetida após uma negação pode alterar o resultado. Mantêm-se barras invertidas e espaços escapados.

Git interpreta os padrões conforme a localização do .gitignore. Um / inicial ancora o padrão nesse local e um / final indica um diretório. * e ** nem sempre têm o mesmo alcance. ! volta a incluir um caminho excluído, mas Git não consegue recuperar um ficheiro se o diretório superior estiver totalmente ignorado. # inicial começa um comentário; escapa-o se o nome começar realmente por esse carácter.

O modelo de ambiente ignora .env e .env.* e depois inclui !.env.example, permitindo versionar um exemplo sem segredos. As regras afetam sobretudo ficheiros não seguidos. Um ficheiro já no índice continua seguido mesmo que corresponda a um novo padrão. O gerador não retira ficheiros do índice, não limpa o histórico nem procura segredos.

Como usar esta ferramenta

  1. Selecionar modelos relevantes

    Escolhe apenas os ambientes realmente usados. Selecionar todas as tecnologias pode introduzir exclusões demasiado amplas.

  2. Acrescentar padrões próprios

    Introduz uma regra por linha e coloca as negações depois das exclusões. Os comentários de secção podem ser desativados.

  3. Verificar com Git

    Descarrega .gitignore, revê-o e confirma um caminho com git check-ignore -v. Examina os ficheiros seguidos antes de ponderares alterações ao índice.

Casos de uso

Iniciar um repositório Node.js

Combina dependências com as saídas da framework usada. Mantém o lockfile e a configuração necessários para instalações reproduzíveis.

Partilhar um exemplo de ambiente

Usa os padrões .env com a exceção .env.example. Confirma que o exemplo contém apenas valores fictícios.

Unir exclusões existentes

Acrescenta exceções nas regras próprias e revê a ordem. Compara o texto com o ficheiro atual antes de o substituíres.

Exemplos

Preservar o ficheiro de exemplo

Sem comentários, o modelo environment produz três linhas. A exceção surge após as exclusões para manter .env.example visível.

Entrada

environment; includeComments=false

Resultado

.env
.env.*
!.env.example

Manter uma ordem significativa

Estas regras próprias mantêm a ordem. A última exclusão pode anular a inclusão anterior; eliminar a repetição mudaria o sentido.

Entrada

custom: *.log
!important.log
*.log

Resultado

*.log
!important.log
*.log

Dicas e boas práticas

  • Retirar um segredo do estado atual não o apaga do histórico. Revoga as credenciais expostas e trata o histórico separadamente.
  • Para preferências pessoais do editor, considera .git/info/exclude ou um ficheiro global em vez de impor a regra à equipa.
  • Mantém fontes e configuração de compilação: ignorar dist não deve ocultar o necessário para o reconstruir.

Fontes e referências

Perguntas frequentes

Onde coloco o ficheiro gerado?

Habitualmente na raiz do repositório. Git também aceita .gitignore aninhados com padrões relativos aos seus diretórios. Ajusta os caminhos se moveres o ficheiro.

Porque aparece num commit um ficheiro ignorado?

Pode já estar seguido. Os padrões não o retiram do índice; examina git ls-files e as alterações preparadas antes de intervir.

São removidos todos os duplicados?

Removem-se repetições exatas entre modelos. As regras próprias mantêm ordem e repetições para respeitar exceções introduzidas por !.

Garante que não existem segredos versionados?

Não. Reúne padrões sem inspecionar ficheiros ou histórico. Exclusões preventivas complementam uma revisão do repositório, sem a substituir.

Ferramentas relacionadas

Ferramentas semelhantes ou complementares a esta.

Ferramentas semelhantes

Compare dois textos linha a linha e identifique rapidamente adições, eliminações e alterações.

DesenvolvimentoEm destaqueUtilizar esta ferramenta

Converta permissões Unix entre notação octal e simbólica e gere um comando chmod.

DesenvolvimentoUtilizar esta ferramenta

Gere instantaneamente um ou vários identificadores UUID v4 aleatórios prontos a copiar.

DesenvolvimentoEm destaqueUtilizar esta ferramenta