Gradle 캐시 주기적으로 관리하는 법 (새로 산 PC)

개발 폴더 · Gradle 홈 캐시 (.gradle) · 새로 산 PC 기준 · 2026-09-24 기준

Gradle 캐시는 쓰는 만큼 다시 쌓입니다. 한 달에 한 번이면 대부분 충분하고, 용량이 빠듯한 기기라면 2주에 한 번으로 당기세요.

얼마나 자주가 적당한가

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

쌓이는 속도를 모르면 주기를 정할 수 없습니다. 지금 크기를 적어 두고, 2주 뒤에 다시 재 보세요. 늘어난 만큼이 2주치입니다. 그 속도에 맞춰 정하면 됩니다.

자동 설정이 없는 항목은 작업 스케줄러로 예약할 수 있습니다. 시작 → "작업 스케줄러" → 기본 작업 만들기 → 매월 → 프로그램 시작에 아래 명령을 넣습니다.

예약해 두면 잊어버려도 됩니다. 다만 무엇을 예약했는지는 메모해 두세요. 반년 뒤에 파일이 없어진 걸 보고 원인을 못 찾으면 곤란합니다.

Remove-Item "$env:USERPROFILE\.gradle\caches" -Recurse -Force -EA SilentlyContinue

새 PC인데 벌써 용량이 없다면 대개 제조사가 미리 깔아 둔 것과 복구 파티션 때문입니다. 실제로 쓸 수 있는 자리가 표기 용량보다 한참 적습니다.

설정 → 앱 → 설치된 앱에서 제조사가 미리 깐 프로그램 중 안 쓰는 것을 지우세요. 그 다음 디스크 관리에서 복구 파티션이 몇 개인지 확인하세요.

이 환경에서 남겨 둘 여유 용량은 최소 20GB 정도로 잡으세요. 체험판 백신과 제조사 유틸리티가 합쳐서 10GB 를 넘기도 합니다.

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

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

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

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

너무 자주 지우면 안 좋나요?

SSD 수명 걱정이라면 의미 있는 수준이 아닙니다. 다만 지울 때마다 프로그램이 다시 만드느라 한동안 느려지므로, 필요 이상으로 자주 할 이유는 없습니다.

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

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

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

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

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