Maven .gitignore 템플릿 해설

Maven.gitignore는 Maven이 빌드와 릴리스 과정에서 만드는 파일을 막는다. 모든 산출물이 target/에 모이도록 설계된 도구라 규칙은 간단하다.

Maven 래퍼는 mvnw, mvnw.cmd, .mvn/wrapper/maven-wrapper.properties를 커밋하고, jar는 템플릿대로 무시하는 방식이 최근 권장 방식이다. 래퍼 스크립트가 필요할 때 jar나 Maven 배포판을 내려받는다.

규칙별 해설

패턴	무엇을, 왜 무시하나
target/	빌드 출력컴파일된 클래스, 테스트 결과, 패키징된 jar·war가 모이는 표준 출력 폴더다. mvn clean으로 지우고 다시 만든다.
pom.xml.tagpom.xml.releaseBackuppom.xml.nextrelease.properties	릴리스 플러그인 파일maven-release-plugin이 release:prepare 중에 만드는 백업과 진행 상태 파일이다. 릴리스가 끝나거나 롤백하면 필요 없다.
pom.xml.versionsBackup	버전 플러그인 백업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.classpath	Eclipse m2e 파일Eclipse가 POM에서 생성하는 프로젝트 파일이다.

실무에서 주의할 점

• .mvn/maven.config와 .mvn/jvm.config는 팀 공통 빌드 옵션이므로 커밋한다. 이 템플릿은 이 두 파일을 무시하지 않는다.
• settings.xml에 저장소 비밀번호를 넣는다면 프로젝트가 아니라 ~/.m2/settings.xml에 둔다.
• IntelliJ를 쓴다면 JetBrains 템플릿을 함께 선택한다.

원본 템플릿

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

함께 쓰는 템플릿

다른 템플릿 해설