Gradle 캐시 — 한눈에 정리 (Windows Server)

개발 폴더 · Gradle 홈 캐시 (.gradle) · Windows Server 기준 · 2026-09-24 기준

안드로이드·자바 프로젝트를 빌드할 때 쓰는 라이브러리와 Gradle 자체를 보관하는 자리입니다. 보통 3~30GB 이고, 지워도 됩니다. 자리는 %USERPROFILE%\.gradle\caches 입니다.

항목	내용
무엇인가	Gradle 홈 캐시 (.gradle)
분류	개발 폴더
전형적인 크기	3~30GB
안전도	지워도 됩니다
지운 뒤 다시 생기나	생깁니다
첫 번째 자리	%USERPROFILE%\.gradle\caches
기준 환경	Windows Server

무엇인가

안드로이드·자바 프로젝트를 빌드할 때 쓰는 라이브러리와 Gradle 자체를 보관하는 자리입니다.

Gradle 버전마다 따로 받고, 라이브러리도 버전마다 쌓입니다. 안드로이드 개발 PC에서 가장 크게 자라는 폴더 중 하나입니다.

어디에 있나

Gradle 캐시는 한 곳에만 있지 않습니다. 아래 2곳을 모두 확인해야 실제 크기가 나옵니다.

경로에 들어 있는 %LOCALAPPDATA% 같은 부분은 탐색기 주소창에서 알아서 풀립니다. 직접 계정 이름을 찾아 들어갈 필요는 없습니다.

%USERPROFILE%\.gradle\caches
%USERPROFILE%\.gradle\wrapper

지워도 되는가

지워도 됩니다

Gradle 캐시는 지워도 됩니다. 다시 생기고, 잃는 게 거의 없습니다.

전부 다시 받을 수 있습니다. 다만 다시 받는 데 시간이 꽤 걸립니다.

지운 뒤에도 프로그램을 다시 쓰면 같은 자리에 다시 생깁니다. 그래서 "한 번 지우면 끝"이 아니라 "얼마나 자주 지울 것인가"의 문제입니다.

지우면 무엇을 잃나

다음 빌드가 처음부터 다시 받느라 10분 이상 걸릴 수 있습니다.

지우는 순서

아래 순서대로 하면 됩니다. 중간에 프로그램이 켜져 있으면 일부 파일이 "사용 중"으로 남으니, 먼저 닫고 시작하세요.

Android Studio 와 모든 빌드를 종료합니다
%USERPROFILE%\.gradle\caches 폴더를 지웁니다
wrapper 폴더 안에 안 쓰는 Gradle 버전이 여러 개 있으면 최신 것만 남기고 지웁니다
다음 빌드에서 필요한 것만 다시 받아집니다

다른 드라이브로 옮기기

환경 변수 GRADLE_USER_HOME 을 D:\gradle 로 지정하면 통째로 옮겨집니다.

Windows Server에서는 무엇이 다른가

서버는 임의로 지우면 서비스가 멈춥니다. 정리는 점검 시간대에, 무엇을 지웠는지 기록을 남기면서 해야 합니다. 저장소 센서 같은 자동 삭제는 켜지 않는 편이 안전합니다.

먼저 DISM /Online /Cleanup-Image /AnalyzeComponentStore 로 정리 여지가 있는지 확인하고, 재부팅 창을 확보한 뒤에 실행하세요.

이 환경에서 남겨 둘 여유 용량은 시스템 볼륨에 20% 이상, 최소 30GB 정도로 잡으세요. 이벤트 로그와 IIS 로그가 조용히 수십 GB로 자라는 대표 주자입니다.

지금 얼마나 차지하는지 확인하기

%USERPROFILE%\.gradle 폴더 속성으로 전체 크기를 보세요. caches 하위가 대부분을 차지합니다.

숫자를 한 번 적어 두세요. 정리한 뒤 다시 재서 비교해야 효과를 알 수 있고, 다음 달에 같은 자리가 또 커졌다면 그건 지울 게 아니라 설정을 바꿔야 하는 항목입니다.

지금 내 PC에서 얼마인지 보려면

테라클린은 이 문서에서 다룬 자리를 찾아 크기와 함께 목록으로 보여주고, 지워도 되는 이유와 안 되는 이유를 항목마다 적습니다. 지우기 전에 목록을 먼저 봅니다. 파일은 기기를 떠나지 않습니다.

Windows용 무료 다운로드 브라우저에서 체험 →

자주 묻는 질문

가장 먼저 무엇을 해야 하나요?

크기부터 재세요. %USERPROFILE%\.gradle 폴더 속성으로 전체 크기를 보세요. caches 하위가 대부분을 차지합니다. 숫자를 보고 나서 지울지 말지 정하면 됩니다.

Gradle 캐시를 지우면 프로그램이 망가지나요?

망가지지 않습니다. 다음 빌드가 처음부터 다시 받느라 10분 이상 걸릴 수 있습니다. 그 이상은 없습니다.

지운 뒤에도 용량이 안 줄어드는데요?

휴지통을 비웠는지 먼저 보세요. 그래도 그대로면 지운 파일을 아직 잡고 있는 프로그램이 있다는 뜻입니다. 재부팅 한 번이면 대개 반영됩니다. 재부팅 뒤에도 같다면 그 자리를 차지하는 건 Gradle 캐시가 아니라 다른 것입니다.

Gradle 캐시에 대한 다른 문서

Gradle 캐시가 무엇인가 Gradle 캐시는 어디에 있나 Gradle 캐시가 지금 몇 GB인지 확인하기 Gradle 캐시가 왜 이렇게 커졌나 Gradle 캐시가 탐색기에 안 보이는 이유 Gradle 캐시, 지워도 되나 Gradle 캐시를 지우면 생기는 문제 Gradle 캐시, 지워도 다시 생기는 이유 Gradle 캐시를 지우면 얼마나 확보되나 Gradle 캐시를 지우면 PC가 빨라지나 Gradle 캐시 정리가 SSD 수명에 영향을 주나 Gradle 캐시 상태 점검하는 법 Gradle 캐시 — 손으로 vs 도구로, 뭐가 나은가 Gradle 캐시 안의 중복본 찾기 Gradle 캐시와 시스템 복원 지점의 관계 Gradle 캐시 지우는 법 Gradle 캐시, 망가뜨리지 않고 지우는 법 Gradle 캐시 다른 드라이브로 옮기기 Gradle 캐시 — 명령어 한 줄로 정리하기 PowerShell로 Gradle 캐시 정리하기 디스크 정리 도구로 Gradle 캐시 없애기 저장소 센서로 Gradle 캐시 관리하기 Gradle 캐시 주기적으로 관리하는 법 심볼릭 링크로 Gradle 캐시 옮기기

Gradle 캐시 문서 전체 보기 (47편)

같이 보면 좋은 것

Android Studio 캐시 Maven 저장소 빌드 산출물

이 문서는 Gradle 홈 캐시 (.gradle)에 대한 한눈에 정리 문서입니다(Windows Server 기준). 경로와 명령어는 확인한 것만 적었고, 확인하지 못한 항목은 비워 두었습니다. 지우기 전에 반드시 크기를 먼저 재고, 되돌릴 수 없는 항목은 사본을 두세요.