PowerShell로 node_modules 정리하기 (미니 PC)

개발 폴더 · node_modules 폴더 · 미니 PC 기준 · 2026-09-24 기준

PowerShell을 관리자로 열고, 먼저 크기를 재고 그 다음에 지우는 순서로 갑니다. 크기를 안 재고 지우면 얼마나 확보했는지 알 수 없고, 다음에 또 같은 자리를 의심하게 됩니다.

① 크기부터 잰다

아래를 붙여 넣으면 폴더 크기가 MB 단위로 나옵니다.

$p = "프로젝트 폴더\node_modules"
"{0:N0} MB" -f ((Get-ChildItem $p -Recurse -File -ErrorAction SilentlyContinue | Measure-Object Length -Sum).Sum / 1MB)

폴더는 남기고 안의 내용만 지웁니다. 쓰는 중인 파일은 알아서 건너뜁니다.

Get-ChildItem "프로젝트 폴더\node_modules" -Recurse -Force -ErrorAction SilentlyContinue |
  Remove-Item -Recurse -Force -ErrorAction SilentlyContinue

쓰는 중인 파일은 지워지지 않고 빨간 오류를 냅니다. 이 옵션이 없으면 오류가 화면을 가득 채워서 정작 무엇이 지워졌는지 안 보입니다. 지워질 건 지워지고, 안 지워질 건 조용히 넘어갑니다.

다시 설치하는 데 드는 시간(1~5분)과 인터넷 트래픽뿐입니다.

같이 지우면 안 되는 것이 있습니다. lock 파일(package-lock.json 등)은 지우지 마세요. 그게 없으면 다시 설치할 때 버전이 달라져 프로젝트가 깨질 수 있습니다.

미니 PC는 eMMC나 작은 SSD가 붙어 있는 경우가 많고, 발열 때문에 디스크 속도가 떨어지기도 합니다. 용량과 열을 같이 봐야 합니다.

대부분 M.2 슬롯이 하나는 있습니다. 정리로 버티기 전에 슬롯이 비어 있는지부터 확인해 보세요.

이 환경에서 남겨 둘 여유 용량은 최소 15GB 정도로 잡으세요. 기본 탑재 용량이 작아 업데이트 실패가 잦습니다.

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

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

PowerShell이 스크립트를 실행하지 못하게 막습니다.

한 줄짜리 명령은 실행 정책과 무관하게 동작합니다. 막힌다면 파일로 저장한 스크립트를 돌리려 한 경우입니다. 창에 직접 붙여 넣으세요.

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

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

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

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

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