"저장 공간이 부족합니다" — node_modules부터 확인하기 (SATA SSD)

개발 폴더 · node_modules 폴더 · SATA SSD 기준 · 2026-09-24 기준

지금 당장 자리가 필요하다면 큰 것부터입니다. node_modules는 보통 프로젝트당 200MB~2GB 라서, 이 정도로 급한 불이 꺼진다면 여기부터 하세요. 부족한 양이 그보다 훨씬 크면 이건 나중이고, 먼저 더 큰 항목을 찾아야 합니다.

항목	내용
무엇인가	node_modules 폴더
분류	개발 폴더
전형적인 크기	프로젝트당 200MB~2GB
안전도	지워도 됩니다
지운 뒤 다시 생기나	생깁니다
첫 번째 자리	프로젝트 폴더\node_modules
기준 환경	SATA SSD

급할 때 순서

① 휴지통 비우기 — 0초, 즉시 반영됩니다. 여기서 몇 GB가 나오는 경우가 생각보다 많습니다.

② 다운로드 폴더의 설치 파일 — 이미 설치한 프로그램의 설치 파일은 남길 이유가 없습니다.

③ node_modules — 프로젝트당 200MB~2GB 정도가 나옵니다. PowerShell 에서 Get-ChildItem -Filter node_modules -Recurse -Directory 로 목록을 뽑고, 각 폴더 크기를 더하면 됩니다. 프로젝트가 많을수록 합계가 놀랍습니다.

④ 그래도 모자라면 큰 파일 찾기로 넘어가세요. 1GB 넘는 것만 보면 대개 원인이 바로 보입니다.

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

PowerShell 에서 Get-ChildItem -Filter node_modules -Recurse -Directory 로 목록을 뽑고, 각 폴더 크기를 더하면 됩니다. 프로젝트가 많을수록 합계가 놀랍습니다.

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

node_modules 비우기

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

프로젝트 폴더에 package.json 과 package-lock.json(또는 yarn.lock, pnpm-lock.yaml)이 있는지 확인합니다
에디터와 개발 서버를 모두 종료합니다
node_modules 폴더를 지웁니다
다시 쓸 때 npm install 을 한 번 실행하면 그대로 돌아옵니다

명령어로 한 번에

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

현재 폴더 아래 모든 프로젝트의 node_modules 를 한 번에 지웁니다. 프로젝트 루트가 아니라 상위 폴더에서 실행하세요.

Get-ChildItem -Path . -Filter node_modules -Recurse -Directory -EA SilentlyContinue | Remove-Item -Recurse -Force

경고가 다시 뜨지 않게 하려면

SATA SSD 환경에서는 전체 용량의 10% 를 늘 남겨 두세요. 그 아래로 내려가면 경고 전에 이미 여러 기능이 조용히 실패하기 시작합니다.

한 달에 한 번 점검일을 달력에 넣어 두는 것만으로도 경고를 볼 일이 크게 줄어듭니다.

SATA SSD에서는 무엇이 다른가

SATA SSD는 NVMe보다 느리지만 같은 원리로 움직입니다. 꽉 차면 느려지고, 지운 뒤 TRIM이 돌아야 실제로 자리가 납니다.

오래 쓴 SATA SSD라면 지우기 전에 SMART 상태를 한 번 보세요. 수명이 다해가는 디스크는 정리보다 교체가 먼저입니다.

이 환경에서 남겨 둘 여유 용량은 전체 용량의 10% 정도로 잡으세요. 조각 모음을 돌리지 마세요. SSD에는 수명만 깎고 효과가 없습니다.

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

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

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

자주 묻는 질문

경고를 무시하고 계속 쓰면 어떻게 되나요?

업데이트가 실패하고, 프로그램이 저장에 실패하고, 나중에는 부팅이 느려집니다. 완전히 0이 되면 로그인조차 안 되는 경우가 있습니다.

node_modules를 지우면 프로그램이 망가지나요?

망가지지 않습니다. 다시 설치하는 데 드는 시간(1~5분)과 인터넷 트래픽뿐입니다. 그 이상은 없습니다.

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

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

node_modules에 대한 다른 문서

node_modules가 무엇인가 node_modules는 어디에 있나 node_modules가 지금 몇 GB인지 확인하기 node_modules가 왜 이렇게 커졌나 node_modules가 탐색기에 안 보이는 이유 node_modules, 지워도 되나 node_modules를 지우면 생기는 문제 node_modules에서 남겨야 하는 것 node_modules, 지워도 다시 생기는 이유 node_modules를 지우면 얼마나 확보되나 node_modules를 지우면 PC가 빨라지나 node_modules 정리가 SSD 수명에 영향을 주나 node_modules 상태 점검하는 법 node_modules에 대해 잘못 알려진 것 node_modules, 비슷한 것과 어떻게 다른가 node_modules — 손으로 vs 도구로, 뭐가 나은가 node_modules 안의 중복본 찾기 node_modules와 시스템 복원 지점의 관계 node_modules 지우는 법 node_modules, 망가뜨리지 않고 지우는 법 node_modules, 지우지 않고 줄이는 법 node_modules — 명령어 한 줄로 정리하기 PowerShell로 node_modules 정리하기 디스크 정리 도구로 node_modules 없애기

node_modules 문서 전체 보기 (50편)

같이 보면 좋은 것

npm 캐시 Yarn 캐시 pnpm 저장소 빌드 산출물

이 문서는 node_modules 폴더에 대한 용량 부족 경고 떴을 때 문서입니다(SATA SSD 기준). 경로와 명령어는 확인한 것만 적었고, 확인하지 못한 항목은 비워 두었습니다. 지우기 전에 반드시 크기를 먼저 재고, 되돌릴 수 없는 항목은 사본을 두세요.