디스크가 완전히 꽉 찼을 때 — Gradle 캐시 응급 처치 (Windows 11)

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

완전히 꽉 차면 탐색기조차 버벅입니다. 이럴 때는 GUI를 쓰지 말고 명령 창으로 바로 가세요. 아래 한 줄이면 됩니다. 몇 GB만 확보되면 나머지는 평소처럼 할 수 있습니다.

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

왜 탐색기가 안 되나

윈도우는 파일을 열고 지우는 데도 임시 자리가 필요합니다. 0에 가까우면 그 자리조차 없어서 창이 안 뜨거나 응답이 없습니다.

명령 창은 훨씬 적은 자리로 동작합니다. 그래서 이 상황에서는 명령 창이 유일한 길인 경우가 많습니다.

명령 창 여는 법

Ctrl+Shift+Esc 로 작업 관리자 → 파일 → 새 작업 실행 → powershell 입력 → "관리자 권한으로 실행" 체크 → 확인.

시작 메뉴가 아예 반응하지 않을 때도 이 방법은 됩니다.

명령어로 한 번에

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

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

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

명령이 따로 없다면

폴더 안의 내용을 통째로 비우는 한 줄입니다.

Get-ChildItem "%USERPROFILE%\.gradle\caches" -Recurse -Force -EA SilentlyContinue | Remove-Item -Recurse -Force -EA SilentlyContinue

급한 불을 끈 다음

휴지통을 비우세요. 지운 게 휴지통에 있으면 용량은 그대로입니다.

재부팅 한 번 하세요. 지운 파일을 잡고 있던 프로그램이 놓으면서 실제 용량이 반영됩니다.

시스템 드라이브에 최소 20GB, 대형 업데이트를 받으려면 30GB 까지 확보하는 걸 목표로 하세요. 예약된 저장소와 업데이트 캐시가 한 번에 20GB를 넘기는 일이 흔합니다.

Windows 11에서는 무엇이 다른가

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

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

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

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

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

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

자주 묻는 질문

로그인이 안 됩니다.

용량 0이면 사용자 프로필을 불러오지 못해 임시 프로필로 로그인되거나 아예 실패합니다. 안전 모드로 부팅하면 자리를 덜 쓰므로 들어갈 수 있는 경우가 많습니다.

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)에 대한 남은 용량이 0일 때 문서입니다(Windows 11 기준). 경로와 명령어는 확인한 것만 적었고, 확인하지 못한 항목은 비워 두었습니다. 지우기 전에 반드시 크기를 먼저 재고, 되돌릴 수 없는 항목은 사본을 두세요.