Gradle 캐시 지우는 법 (일체형 PC)

개발 폴더 · Gradle 홈 캐시 (.gradle) · 일체형 PC 기준 · 2026-09-24 기준

Gradle 캐시는 %USERPROFILE%\.gradle\caches 에 있습니다. 프로그램을 완전히 닫고, 그 폴더 안의 내용물을 지우면 됩니다. 전형적으로 3~30GB 정도가 비워집니다. 지워도 다시 생기는 것이라 되돌릴 걱정은 없습니다.

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

Gradle 캐시가 무엇인지 30초

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

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

어디에 있나

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

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

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

지우는 순서

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

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

명령어로 한 번에

창을 여러 개 열지 않고 끝내려면 아래 한 줄이면 됩니다.

실행하기 전에 무엇을 지우는 명령인지 한 번 읽어 보세요. 되돌리기 버튼이 없습니다.

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

지우면 무엇을 잃나

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

일체형 PC에서는 무엇이 다른가

일체형 PC는 모니터 안에 부품이 들어 있어 디스크 교체가 어렵거나 보증이 깨집니다. 외장 저장장치와 정리로 버텨야 하는 환경입니다.

USB 3.0 이상 외장 SSD를 하나 두고, 사진·영상 같은 큰 보관물을 통째로 옮기세요. 내장은 시스템과 지금 쓰는 것만 남깁니다.

이 환경에서 남겨 둘 여유 용량은 최소 20GB 정도로 잡으세요. 제조사가 미리 깔아 둔 복구 파티션이 수십 GB를 차지하고 있기도 합니다.

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

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

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

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

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

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

자주 묻는 질문

폴더 자체를 지워도 되나요?

폴더 안의 내용만 지우세요. 폴더 자체를 지우면 프로그램이 다시 만들 때까지 오류를 낼 수 있습니다. 내용만 비우면 같은 효과에 위험은 없습니다.

얼마나 자주 지우면 되나요?

쓰는 만큼 다시 쌓입니다. 용량이 빠듯하면 한 달에 한 번, 여유가 있으면 용량 경고가 뜰 때만 해도 충분합니다.

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 캐시 — 명령어 한 줄로 정리하기 PowerShell로 Gradle 캐시 정리하기 디스크 정리 도구로 Gradle 캐시 없애기 저장소 센서로 Gradle 캐시 관리하기 Gradle 캐시 주기적으로 관리하는 법 심볼릭 링크로 Gradle 캐시 옮기기 Gradle 캐시 여러 개 한 번에 정리하기

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

같이 보면 좋은 것

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

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