Go 모듈 캐시 지우는 법 (NAS·네트워크 드라이브)

개발 폴더 · Go 모듈 캐시 (GOMODCACHE) · NAS·네트워크 드라이브 기준 · 2026-09-24 기준

Go 모듈 캐시는 %USERPROFILE%\go\pkg\mod 에 있습니다. 프로그램을 완전히 닫고, 그 폴더 안의 내용물을 지우면 됩니다. 전형적으로 1~15GB 정도가 비워집니다. 지워도 다시 생기는 것이라 되돌릴 걱정은 없습니다.
항목내용
무엇인가Go 모듈 캐시 (GOMODCACHE)
분류개발 폴더
전형적인 크기1~15GB
안전도지워도 됩니다
지운 뒤 다시 생기나생깁니다
첫 번째 자리%USERPROFILE%\go\pkg\mod
기준 환경NAS·네트워크 드라이브

Go 모듈 캐시가 무엇인지 30초

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

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

어디에 있나

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

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

%USERPROFILE%\go\pkg\mod

지우는 순서

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

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

명령어로 한 번에

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

읽기 전용 파일이 많아 손으로 지우면 권한 오류가 납니다. 반드시 이 명령을 쓰세요.

go clean -modcache

지우면 무엇을 잃나

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

NAS·네트워크 드라이브에서는 무엇이 다른가

네트워크 드라이브는 랜선 속도만큼만 빠릅니다. 큰 파일을 옮겨 두기에는 좋지만, 프로그램이 상시로 읽는 자리로는 맞지 않습니다.

옮긴 뒤 원본을 지우려면 먼저 네트워크가 끊긴 상태에서 그 프로그램이 정상으로 뜨는지 확인하세요. 안 뜨면 그 폴더는 옮기면 안 되는 것입니다.

이 환경에서 남겨 둘 여유 용량은 볼륨의 10% 정도로 잡으세요. 동기화 폴더를 NAS에 두면 충돌 사본이 쌓이기 쉽습니다.

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

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

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

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

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

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

자주 묻는 질문

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

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

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

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

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

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

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

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

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

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

환경별로 보기

환경 구분 없이 보기

같이 보면 좋은 것

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