github/gitignore · Maven.gitignore
Template .gitignore do Maven explicado
Explica por que o Maven.gitignore ignora a pasta target, os backups do plugin de release, os artefatos do plugin shade, o jar do wrapper do Maven e os arquivos do Eclipse.
O Maven.gitignore bloqueia os arquivos que o Maven cria durante o build e o processo de release. É uma ferramenta projetada para que todos os artefatos se concentrem em target/, então as regras são simples.
O recomendado atualmente para o wrapper do Maven é commitar mvnw, mvnw.cmd e .mvn/wrapper/maven-wrapper.properties e ignorar o jar, como faz o template. O script do wrapper baixa o jar ou a distribuição do Maven quando necessário.
Explicação regra por regra
| Padrão | O que ignora e por quê |
|---|---|
target/ | Saída de buildÉ a pasta de saída padrão onde se reúnem as classes compiladas, os resultados de testes e os jars e wars empacotados. É apagada com mvn clean e criada de novo. |
pom.xml.tagpom.xml.releaseBackuppom.xml.nextrelease.properties | Arquivos do plugin de releaseSão os backups e arquivos de estado que o maven-release-plugin cria durante o release:prepare. Quando o release termina ou é revertido, não são mais necessários. |
pom.xml.versionsBackup | Backup do plugin de versõesÉ a cópia do original que o versions-maven-plugin deixa antes do versions:set. |
dependency-reduced-pom.xmlbuildNumber.properties | Arquivos gerados por pluginsSão o POM reduzido criado pelo maven-shade-plugin e o arquivo de numeração do plugin buildnumber. |
.mvn/timing.properties | Medições locaisSão os resultados da medição do tempo de build, cujo valor muda de pessoa para pessoa. |
.mvn/wrapper/maven-wrapper.jar | Jar do wrapperÉ um binário que o script do wrapper pode baixar quando precisar. A documentação do Maven Wrapper linkada no template explica como usá-lo sem o jar. |
.project.classpath | Arquivos m2e do EclipseSão arquivos de projeto que o Eclipse gera a partir do POM. |
Cuidados na prática
.mvn/maven.confige.mvn/jvm.configsão opções de build comuns à equipe, então commite-os. Este template não ignora esses dois arquivos.- Se você coloca senhas de repositórios no
settings.xml, guarde-o em~/.m2/settings.xml, e não no projeto. - Se você usa o IntelliJ, selecione também o template JetBrains.
Template original
Maven.gitignore
target/pom.xml.tagpom.xml.releaseBackuppom.xml.versionsBackuppom.xml.nextrelease.propertiesdependency-reduced-pom.xmlbuildNumber.properties.mvn/timing.properties# https://maven.apache.org/tools/wrapper/#Usage_with_or_without_Binary_JAR.mvn/wrapper/maven-wrapper.jar# Eclipse m2e generated files# Eclipse Core.project# JDT-specific (Eclipse Java Development Tools).classpath
Origem dos templates: github/gitignore/Maven.gitignore @356fd7b (2026-09-11) · CC0-1.0