VS Code 사용시

.gradle 폴더가 있는 프로젝트 루트 디렉토리에서

📁 프로젝트명
├─ gradlew
├─ gradlew.bat
├─ build.gradle (또는 build.gradle.kts)
├─ settings.gradle
├─ .gradle ← 이거!
├─ build

gradlew 파일이 있는 위치에서 실행

gradlew --stop
rmdir /s /q .gradle
rmdir /s /q build
gradlew clean

명령어 실행

Gradle 캐시 + 빌드 산출물 + 실행 중인 데몬 전부 정리
프로젝트를 처음 받았을 때 상태로 되돌림

gradlew --stop

Gradle 데몬 종료
Gradle은 빌드 속도를 높이려고 백그라운드 데몬 프로세스를 띄우둠
이 데몬이 이전 설정을 물고 있거나 JDK/Gradle 버전 꼬임, 캐시 문제를 일으킬 수 있음
gradlew --stop 은 지금 떠 있는 Gradle 데모들 전부 끄라는 설정
Gradle 설정 바꿨는데 반영 안 될 때, 빌드가 이상하게 계속 실패할 때 씀

rmdir /s /q .gradle

프로젝트 로컬 Gradle 캐시 삭제
.gradle 폴더는 프로젝트별 캐시 task 실행 결과, dependency 해석 정보, 이전 빌드 상태
이게 깨지면 갑자기 에러, 남들은 되는데 나만 안 됨, 의존성 관련 이상 현상 나타남

삭제 효과 - 이 프로젝트 Gradle 캐시 싹 지우고 새로 계산해
안 지우면 캐시가 꼬인 상태로 계속 빌드 시도함

rmdir /s /q build

빌드 결과물 삭제
build/ 안에는 컴파일된 class, jar / war, 테스트 결과, 리소스 복사본이 있음
삭제 효과 이전에 빌드된 산출물 전부 삭제
예전 결과물이 남아서 변경 안 했는데 동작이 이상함, 디버깅 안 맞음

gradlew clean

Gradle 공식 정리 명령
내부적으로 하는 일 : build/ 디렉토리 삭제
Gradle이 아는 범위 내에서만 정리함
차이점
rmdir build : 강제 삭제(Gradle 무시)
gradlew clean : Gradle 규칙에 따른 삭제
그래서 보통 둘 다 쓰는 경우도 많음

완전히 새 프로젝트처럼 다시 빌드

언제 사용?

• 프로젝트 처음 받을 때
• 브랜치 바꿨는데 빌드 안 될 때
• JDK / Gradle 버전 바꿨을 때
• "이유 없는 에러"가 날 때