Gradle 캐시 정리 — 처음 하는 사람을 위한 설명 (Windows 11)

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

어렵지 않습니다. 안드로이드·자바 프로젝트를 빌드할 때 쓰는 라이브러리와 Gradle 자체를 보관하는 자리입니다. 지워도 프로그램이 다시 만들어 주기 때문에 고장 날 일이 없습니다. 아래 순서대로만 하면 3~30GB 정도가 비워집니다.
항목내용
무엇인가Gradle 홈 캐시 (.gradle)
분류개발 폴더
전형적인 크기3~30GB
안전도지워도 됩니다
지운 뒤 다시 생기나생깁니다
첫 번째 자리%USERPROFILE%\.gradle\caches
기준 환경Windows 11

먼저, 이게 뭔지

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

쉽게 말하면 프로그램이 일하면서 남긴 것입니다. Gradle 버전마다 따로 받고, 라이브러리도 버전마다 쌓입니다. 안드로이드 개발 PC에서 가장 크게 자라는 폴더 중 하나입니다.

지우면 안 되는 거 아닌가요?

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

지워도 다시 만들어집니다. 처음 한 번 프로그램이 느릴 수 있는데, 그게 다시 만드는 중이라는 뜻입니다. 곧 원래대로 돌아옵니다.

따라 하기

천천히 하나씩 하시면 됩니다. 중간에 막히면 거기서 멈춰도 됩니다 — 반쯤 하다 멈춰도 망가지지 않습니다.

  1. 해당 프로그램 창을 전부 닫습니다.
  2. 화면 오른쪽 아래 시계 옆에 그 프로그램 아이콘이 있으면, 오른쪽 클릭해서 종료를 누릅니다.
  3. Android Studio 와 모든 빌드를 종료합니다
  4. %USERPROFILE%\.gradle\caches 폴더를 지웁니다
  5. wrapper 폴더 안에 안 쓰는 Gradle 버전이 여러 개 있으면 최신 것만 남기고 지웁니다
  6. 다음 빌드에서 필요한 것만 다시 받아집니다
  7. 바탕화면의 휴지통을 오른쪽 클릭 → 휴지통 비우기를 누릅니다.

자주 틀리는 것

창을 닫는 것과 프로그램을 끄는 것은 다릅니다. 시계 옆 아이콘까지 확인하세요.

휴지통을 안 비우면 용량이 그대로입니다. 이게 제일 흔한 실수입니다.

Windows 11에서는 무엇이 다른가

Windows 11은 설정 앱이 개편되면서 저장소 화면 위치가 바뀌었고, 예약된 저장소(Reserved Storage)가 기본으로 켜져 있어 업데이트용으로 7GB 안팎을 미리 물고 있습니다. 탐색기에서 본 "사용 중"과 실제로 쓸 수 있는 자리가 벌어지는 첫 번째 이유입니다.

설정 → 시스템 → 저장소 → 정리 권장 사항을 먼저 여세요. Windows 10의 디스크 정리(cleanmgr)가 하던 일을 여기서 더 자세히 보여주고, 임시 파일 항목별로 크기가 같이 나옵니다.

이 환경에서 남겨 둘 여유 용량은 시스템 드라이브에 최소 20GB, 대형 업데이트를 받으려면 30GB 정도로 잡으세요. 예약된 저장소와 업데이트 캐시가 한 번에 20GB를 넘기는 일이 흔합니다.

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

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

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

자주 묻는 질문

하다가 실수하면 컴퓨터가 망가지나요?

망가지지 않습니다. 여기서 다루는 건 지워도 되는 것들입니다.

무서우면 안 해도 되나요?

됩니다. 용량에 여유가 있으면 굳이 안 해도 됩니다. 정리는 자리가 부족할 때 하는 일이지, 정기적으로 꼭 해야 하는 일이 아닙니다.

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

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

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

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

Gradle 캐시에 대한 다른 문서

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

환경별로 보기

환경 구분 없이 보기

같이 보면 좋은 것

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