Entendendo o arquivo .gitignore
Aprenda como o .gitignore mantém arquivos indesejados fora do seu repositório, usando padrões, regras de escopo e evitando armadilhas comuns.
Entendendo o arquivo .gitignore é uma aula grátis de Git & GitHub Professional Workflow no CoddyKit. Esta é a aula 4 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Git & GitHub Professional Workflow, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Git & GitHub Professional Workflow inclui 4 aulas no total.
Nem tudo pertence ao Git
Artefatos de compilação, registros, segredos e pastas de dependências nunca devem ser adicionados ao repositório. O arquivo .gitignore informa ao Git exatamente quais arquivos devem ser ignorados.
O que é o .gitignore?
Um .gitignore é simplesmente um arquivo de texto cheio de padrões. Qualquer caminho que corresponda a um padrão fica fora da área de preparação e das confirmações, mantendo o repositório organizado.
Criando seu primeiro .gitignore
Coloque um .gitignore na raiz do repositório, com um padrão por linha. O exemplo abaixo ignora dependências, registros e seu arquivo de ambiente.
# .gitignore
node_modules/
*.log
.envRegras básicas de padrões
Os padrões básicos: *.log corresponde pela extensão, build/ corresponde a um diretório inteiro e um nome simples corresponde a exatamente um arquivo.
*.tmp
dist/
config.local.jsonFixando com uma barra inicial
Uma barra inicial fixa um padrão na raiz do repositório; assim, /todo.txt ignora somente o arquivo no nível superior, e não outro com o mesmo nome em uma parte mais profunda da árvore.
# only ignores /todo.txt at the root
/todo.txt
# ignores todo.txt anywhere
todo.txtNegação com um ponto de exclamação
Adicione ! ao início de um padrão para deixar de ignorar algo que uma regra anterior excluiu, como ignorar todos os registros, exceto um que você queira manter.
# ignore all logs except the important one
*.log
!important.logCaracteres curinga: asterisco e asterisco duplo
Para usar caracteres curinga: um único * corresponde a qualquer coisa, exceto uma barra, enquanto ** pode atravessar diretórios em qualquer profundidade.
# any file in any logs directory at any depth
**/logs/*.log
# any .cache file in this dir or below
**/*.cacheComentários e linhas em branco
Linhas que começam com # são comentários, e linhas em branco são ignoradas; use ambos para manter seu .gitignore organizado e legível.
# Dependencies
node_modules/
# Environment
.envArmadilha dos arquivos já rastreados
Uma grande armadilha: o .gitignore só afeta arquivos não rastreados. Se um arquivo já for rastreado, a regra não terá efeito até que você deixe de rastreá-lo com git rm --cached.
git rm --cached secret.txt
# now the ignore rule takes effect for future commitsVerificando por que um arquivo é ignorado
Não sabe por que um caminho é ignorado? git check-ignore -v informa exatamente qual regra e linha corresponderam a ele.
git check-ignore -v build/app.js
# .gitignore:2:build/ build/app.jsIgnoramento global
Para elementos pessoais (configurações do editor e resíduos do OS) que nunca devem chegar a nenhum repositório, defina um ignoramento global em vez de poluir os arquivos do projeto.
git config --global core.excludesFile ~/.gitignore_globalVerificação rápida
Teste seu conhecimento sobre .gitignore.
Recapitulação
Você dominou o .gitignore: padrões, caracteres curinga (*, **), fixação na raiz (/) e negação (!). Lembre-se de que ele só afeta arquivos não rastreados; depure usando git check-ignore.
Perguntas Frequentes
A aula “Entendendo o arquivo .gitignore” é grátis?
Sim — o texto completo de “Entendendo o arquivo .gitignore” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Git & GitHub Professional Workflow, atualize para CoddyKit PRO. O curso de Git & GitHub Professional Workflow inclui 4 aulas no total.
O que vou aprender em “Entendendo o arquivo .gitignore”?
Aprenda como o .gitignore mantém arquivos indesejados fora do seu repositório, usando padrões, regras de escopo e evitando armadilhas comuns. Você pratica Git & GitHub Professional Workflow com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar Git & GitHub Professional Workflow?
Nenhuma experiência prévia é necessária. Git & GitHub Professional Workflow no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 4 de 4.
Quanto tempo leva a aula “Entendendo o arquivo .gitignore”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de Git & GitHub Professional Workflow?
Sim. Cada aula de Git & GitHub Professional Workflow inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Introdução ao controle de versões
- Instalação e configuração do Git
- Criando seu primeiro repositório
- Entendendo o arquivo .gitignore