github/gitignore · Maven.gitignore

Maven .gitignore 模板详解

说明 Maven.gitignore 忽略 target 目录、release 插件备份、shade 插件产物、Maven 包装器 jar 和 Eclipse 文件的原因。

在生成器中打开 与 Java, JetBrains, macOS 一起打开

Maven.gitignore 拦截 Maven 在构建和发布过程中生成的文件。由于这个工具的设计是把所有产物集中到 target/,规则很简单。

对于 Maven 包装器,近来推荐的做法是提交 mvnwmvnw.cmd.mvn/wrapper/maven-wrapper.properties,并按模板忽略 jar。包装器脚本会在需要时下载 jar 或 Maven 发行版。

逐条规则详解

模式忽略什么,为什么忽略
target/构建输出存放编译后的类、测试结果以及打包好的 jar、war 的标准输出目录。用 mvn clean 删除后重新生成。
pom.xml.tagpom.xml.releaseBackuppom.xml.nextrelease.propertiesrelease 插件文件maven-release-plugin 在 release:prepare 期间生成的备份和进度状态文件。发布完成或回滚后就不再需要。
pom.xml.versionsBackupversions 插件备份versions-maven-plugin 在 versions:set 之前留下的原始文件备份。
dependency-reduced-pom.xmlbuildNumber.properties插件生成文件maven-shade-plugin 生成的精简 POM,以及 buildnumber 插件的编号文件。
.mvn/timing.properties本地测量值构建耗时的测量结果,每个人的值都不同。
.mvn/wrapper/maven-wrapper.jar包装器 jar包装器脚本可以在需要时下载的二进制文件。模板中链接的 Maven Wrapper 文档说明了不使用 jar 的方法。
.project.classpathEclipse m2e 文件Eclipse 根据 POM 生成的项目文件。

实践中的注意事项

原始模板

Maven.gitignore规则 12 行
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

模板来源: github/gitignore/Maven.gitignore @356fd7b (2026-09-11) · CC0-1.0

常搭配使用的模板

其他模板详解