Go 모듈 캐시 — 한눈에 정리 (Windows Server)

개발 폴더 · Go 모듈 캐시 (GOMODCACHE) · Windows Server 기준 · 2026-09-24 기준

Go 프로젝트가 쓰는 모듈을 계정 단위로 모아 두는 창고입니다. 보통 1~15GB 이고, 지워도 됩니다. 자리는 %USERPROFILE%\go\pkg\mod 입니다.
항목내용
무엇인가Go 모듈 캐시 (GOMODCACHE)
분류개발 폴더
전형적인 크기1~15GB
안전도지워도 됩니다
지운 뒤 다시 생기나생깁니다
첫 번째 자리%USERPROFILE%\go\pkg\mod
기준 환경Windows Server

무엇인가

Go 프로젝트가 쓰는 모듈을 계정 단위로 모아 두는 창고입니다.

모듈과 버전이 늘 때마다 쌓입니다. 읽기 전용으로 저장돼 지울 때 권한 오류가 나기 쉽습니다.

어디에 있나

Go 모듈 캐시의 자리는 한 곳입니다. 탐색기 주소창에 아래 경로를 그대로 붙여 넣으면 바로 열립니다.

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

%USERPROFILE%\go\pkg\mod

지워도 되는가

지워도 됩니다

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

다시 받을 수 있습니다.

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

지우면 무엇을 잃나

다음 빌드가 모듈을 다시 받느라 오래 걸립니다.

지우는 순서

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

  1. go clean -modcache 를 실행합니다
  2. 탐색기로 직접 지우면 읽기 전용 속성 때문에 실패하니 이 명령을 쓰세요
  3. 빌드 캐시도 따로 있습니다 — go clean -cache

다른 드라이브로 옮기기

환경 변수 GOMODCACHE 로 위치를 바꿀 수 있습니다.

Windows Server에서는 무엇이 다른가

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

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

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

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

%USERPROFILE%\go\pkg\mod 폴더 속성으로 크기를 보세요.

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

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

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

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

자주 묻는 질문

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

크기부터 재세요. %USERPROFILE%\go\pkg\mod 폴더 속성으로 크기를 보세요. 숫자를 보고 나서 지울지 말지 정하면 됩니다.

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

망가지지 않습니다. 다음 빌드가 모듈을 다시 받느라 오래 걸립니다. 그 이상은 없습니다.

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

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

Go 모듈 캐시에 대한 다른 문서

Go 모듈 캐시 문서 전체 보기 (47편)

환경별로 보기

환경 구분 없이 보기

같이 보면 좋은 것

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