github/gitignore · Gradle.gitignore
Gradle .gitignore 템플릿 해설
Gradle.gitignore가 .gradle과 build 폴더를 무시하면서 src 아래 build 폴더와 Gradle 래퍼 jar를 부정 패턴으로 되살리는 구조를 설명합니다.
Gradle.gitignore는 9줄뿐이지만 부정 패턴을 세 번 써서 무시하면 안 되는 것을 정확히 지키는 템플릿이다. Java·Kotlin 템플릿과 함께 쓰는 경우가 대부분이다.
Gradle 래퍼(gradlew, gradle/wrapper/gradle-wrapper.jar, gradle-wrapper.properties)는 Gradle을 설치하지 않은 사람도 같은 버전으로 빌드하게 해 주므로 반드시 커밋해야 한다. Gradle 공식 문서도 래퍼 파일을 버전 관리에 넣으라고 안내한다.
규칙별 해설
| 패턴 | 무엇을, 왜 무시하나 |
|---|---|
.gradle | Gradle 캐시프로젝트별 작업 캐시와 파일 해시가 저장되는 폴더다. 지우면 다음 빌드에서 다시 만든다. |
**/build/!**/src/**/build/ | 빌드 폴더와 예외모든 모듈의 build/ 출력 폴더를 제외하되, 소스 트리(src/) 안에 우연히 build라는 이름의 패키지·폴더가 있으면 되살린다. 예를 들어 src/main/java/com/example/build/가 빌드 산출물로 오인되어 사라지는 일을 막는다. |
!gradle-wrapper.jar!gradle-wrapper.properties | 래퍼 보호Java·Kotlin 템플릿의 *.jar 규칙이 래퍼 jar를 무시하지 않도록 다시 포함한다. git은 마지막에 일치한 규칙을 따르므로 이 줄이 *.jar보다 뒤에 있어야 효과가 있다. |
gradle-app.setting.gradletasknamecache | GUI·태스크 캐시Gradle GUI 설정과 셸 자동완성용 태스크 이름 캐시다. |
.project.classpath | Eclipse 생성 파일Eclipse Buildship이 Gradle 설정에서 생성하는 프로젝트 파일이다. 빌드 스크립트에서 언제든 다시 만들 수 있다. |
실무에서 주의할 점
- 생성기에서 Java(또는 Kotlin)를 먼저, Gradle을 나중에 선택한다. 순서가 반대면
!gradle-wrapper.jar가 앞에 오고*.jar가 뒤에서 다시 무시한다. 패턴 테스터에gradle/wrapper/gradle-wrapper.jar를 넣어 확인할 수 있다. gradle.properties는 무시 대상이 아니다. 다만 개인 서명 정보나 토큰은 프로젝트 파일이 아니라 사용자 홈의~/.gradle/gradle.properties에 둔다.local.properties(Android SDK 경로)는 이 템플릿에 없으므로 Android 프로젝트라면 Android 템플릿을 함께 쓴다.
원본 템플릿
Gradle.gitignore
.gradle**/build/!**/src/**/build/# Ignore Gradle GUI configgradle-app.setting# Avoid ignoring Gradle wrapper jar file (.jar files are usually ignored)!gradle-wrapper.jar# Avoid ignore Gradle wrapper properties!gradle-wrapper.properties# Cache of project.gradletasknamecache# Eclipse Gradle plugin generated files# Eclipse Core.project# JDT-specific (Eclipse Java Development Tools).classpath
템플릿 출처: github/gitignore/Gradle.gitignore @356fd7b (2026-09-11) · CC0-1.0