Como usar: Gerador de .gitignore
- Escolha tudo o que seu projeto usa — uma linguagem, um framework, seu sistema operacional e seu editor. Ou comece com uma configuração pré-definida.
- Use o filtro para encontrar modelos rapidamente (“next”, “jet”, “docker”).
- Adicione caminhos específicos do projeto nas “Suas próprias regras”; eles são acrescentados no final para que possam substituir regras anteriores com
!. - Baixe o arquivo, salve-o como
.gitignorena raiz do seu repositório e faça o commit.
O que deve constar no arquivo .gitignore?
Tudo o que for gerado, específico da máquina ou confidencial: pastas de dependências (node_modules/, .venv/), resultados de compilação (dist/, .next/), caches, logs, configurações do editor e .env arquivos com credenciais. O código-fonte, os arquivos de bloqueio e as configurações que sua equipe compartilha ficam no Git.
| Padrão | Corresponde a |
|---|---|
node_modules/ | A pasta em qualquer lugar do repositório (barra final = apenas diretórios) |
/dist | Apenas dist na raiz do repositório (a barra inicial fixa a localização) |
*.log | Todos os arquivos que terminam em .log, em qualquer pasta |
**/temp | temp em qualquer nível |
!.env.example | Reinclui um arquivo que uma regra anterior ignorou |
# comment | Linha ignorada — use-a para títulos de seção |
Já fez o commit de um arquivo que agora quer ignorar?
A .gitignore afeta apenas arquivos não rastreados. Para parar de rastrear algo que já está no repositório, execute git rm --cached path/to/file e faça o commit — o Gerador de Comandos do Git cria o comando exato. Se você fez o commit de um segredo, faça a rotação dele: removê-lo do último commit não o remove do histórico. Verifique seus arquivos de ambiente com o Validador de Arquivos .env.
Ignorar por projeto x ignorar globalmente
Arquivos do sistema operacional e do editor (.DS_Store, Thumbs.db, .idea/) também podem ser colocados em um arquivo de ignorados global na sua própria máquina: git config --global core.excludesFile ~/.gitignore_global. Muitas equipes ainda os adicionam ao arquivo do projeto para que ninguém faça commit deles por acidente. Combine seu arquivo de ignorados com um .editorconfig e um README ao iniciar um novo repositório.
Também pesquisado como: .gitignore, gitignore node, gitignore python, gitignore react, gitignore next.js, modelo de gitignore, gitignore macos ds_store, gitignore no vscode.
Ferramentas que combinam com: Gerador de .gitignore
- Gerador de package.json — Preencha o formulário e receba um package.json válido — validação do nome no npm, predefinições de scripts para Vite, Next.js, Node e bibliotecas TypeScript, exports, engines, licença e repositório — com avisos sobre erros comuns.
- Gerador de fluxos de trabalho do GitHub Actions — Escolha sua pilha, gatilhos e etapas e receba um arquivo .github/workflows/ci.yml — instalação, cache, verificação de código, teste, compilação, uma matriz de versões e, opcionalmente, implantação no GitHub Pages, Vercel ou em um registro de contêineres.
- Validador YAML — Cole um arquivo Docker Compose, manifesto Kubernetes, workflow do GitHub Actions ou qualquer YAML para localizar erros, evitar armadilhas comuns e obter uma versão bem formatada.
- Gerador de YAML Kubernetes — Preencha o nome, a imagem e a porta do seu app e receba YAML do Kubernetes pronto para produção: um Deployment com probes, limites de recursos e contexto de segurança reforçado, além do Service, do Ingress com TLS, do ConfigMap, do Secret e do HorizontalPodAutoscaler que você marcar, tudo em um arquivo pronto para kubectl apply.
Perguntas frequentes
Onde eu coloco o arquivo .gitignore?
.gitignore. Você pode adicionar mais arquivos .gitignore nas subpastas; as regras deles se aplicam em relação a essa pasta.Por que um arquivo ainda aparece na lista de arquivos rastreados depois que eu o adicionei ao .gitignore?
git rm --cached <file> (adiciona -r para pastas) e, em seguida, faça o commit. O arquivo continua no seu disco.Devo fazer o commit do `package-lock.json` ou do `yarn.lock`?
O arquivo .env deve estar no .gitignore?
.env e .env.*.local, mas faça um commit de .env.example com os nomes das variáveis e sem valores reais, pra que os colegas de equipe saibam o que definir.