[{"data":1,"prerenderedAt":389},["ShallowReactive",2],{"blog-article-\u002Ftw\u002Fblog\u002Fclean-npm-cache":3},{"id":4,"title":5,"author":6,"body":7,"category":372,"cover":373,"coverAlt":374,"description":375,"draft":376,"extension":377,"meta":378,"navigation":379,"path":380,"publishedAt":381,"seo":382,"stem":383,"tags":384,"translationKey":387,"updatedAt":381,"__hash__":388},"articles_tw\u002Ftw\u002Fblog\u002Fclean-npm-cache.md","npm 快取怎麼清？會刪掉專案的相依套件嗎？","Harry",{"type":8,"value":9,"toc":364},"minimark",[10,14,26,35,40,48,59,62,73,77,90,169,172,184,188,191,219,236,239,254,262,265,283,295,298,302,308,316,322,329,336,339,342,348,360],[11,12,13],"p",{},"專案早就沒在用了，當初安裝套件留下的 npm 快取卻可能還在占空間。它通常放在使用者目錄裡，不一定會隨著專案資料夾一起刪除。",[11,15,16,25],{},[17,18,19,20,24],"strong",{},"npm 下載快取可以清理，它和專案裡的 ",[21,22,23],"code",{},"node_modules"," 是兩回事。"," 在正常的快取設定下，清理下載快取不會移除已安裝的相依套件，也不必重裝 Node.js；只是日後安裝套件時，可能需要重新下載。",[11,27,28,29,34],{},"不想翻隱藏資料夾，可以用 ",[30,31,33],"a",{"href":32},"\u002Ftw","MangoDisk"," 一起找出 npm 和其他支援的開發工具快取，直接比較大小。先看哪一項值得清，就不用對著陌生的資料夾猜用途。",[36,37,39],"h2",{"id":38},"先看看-npm-快取占了多少空間","先看看 npm 快取占了多少空間",[11,41,42,43,47],{},"開啟",[30,44,46],{"href":45},"\u002Ftw\u002Fdocs\u002Ffeatures\u002Fdeep-clean","深度清理","，執行掃描，找到 npm 快取項目。展開結果，就能查看路徑、容量和清理說明，不必自己逐一找資料夾。",[11,49,50],{},[51,52],"img",{"alt":53,"decoding":54,"height":55,"loading":56,"src":57,"width":58},"MangoDisk 深度清理列出 npm 等開發工具快取的容量與勾選狀態","async",1171,"lazy","https:\u002F\u002Fassets.mangodisk.app\u002Fimages\u002Fscreenshots\u002Fwindows\u002Ftw\u002Flight-01-deep-cleanup.jpg",1746,[11,60,61],{},"這次若只想清 npm，先取消其他項目的勾選，再選取要清理的 npm 快取。等套件安裝和相關工作結束，確認路徑及預計釋放的空間後，再執行清理。單純掃描不會刪除檔案。",[11,63,64,65,68,69,72],{},"MangoDisk 的內建規則涵蓋 Windows 常見的 npm 快取位置，以及 macOS 的 ",[21,66,67],{},"~\u002F.npm\u002F_cacache","。",[17,70,71],{},"如果你改過快取位置，請先用下文的指令確認實際路徑","，別把「沒掃到」當成「沒有快取」。",[36,74,76],{"id":75},"npm-快取和-node_modules-差在哪","npm 快取和 node_modules 差在哪？",[11,78,79,80,82,83,89],{},"快取保留下載過的套件資料，方便之後重複使用；",[21,81,23],{}," 則是專案實際使用的相依套件。",[30,84,88],{"href":85,"rel":86},"https:\u002F\u002Fdocs.npmjs.com\u002Fcli\u002Fv11\u002Fconfiguring-npm\u002Ffolders\u002F",[87],"nofollow","npm 官方目錄說明","也將兩者分開存放。",[91,92,93,109],"table",{},[94,95,96],"thead",{},[97,98,99,103,106],"tr",{},[100,101,102],"th",{},"內容",[100,104,105],{},"用途",[100,107,108],{},"清理 npm 下載快取時會怎樣",[110,111,112,124,137,151],"tbody",{},[97,113,114,118,121],{},[115,116,117],"td",{},"npm 下載快取",[115,119,120],{},"安裝時可以重複使用的資料",[115,122,123],{},"刪除快取，之後可能需要重新下載",[97,125,126,131,134],{},[115,127,128,129],{},"專案的 ",[21,130,23],{},[115,132,133],{},"執行或建置專案所需的套件",[115,135,136],{},"不會因此被移除",[97,138,139,142,149],{},[115,140,141],{},"全域安裝的命令列工具",[115,143,144,145,148],{},"透過 ",[21,146,147],{},"npm install -g"," 安裝的軟體",[115,150,136],{},[97,152,153,163,166],{},[115,154,155,156,159,160],{},"原始碼、",[21,157,158],{},"package.json","、",[21,161,162],{},"package-lock.json",[115,164,165],{},"程式碼、相依套件設定與版本紀錄",[115,167,168],{},"不是快取清理對象，應保留",[11,170,171],{},"這裡指的是快取與專案正常分開存放的情況。如果曾把快取路徑設到混放個人檔案的資料夾，請先調整設定，不要直接清空。",[11,173,174,175,177,178,183],{},"也別為了清快取，順手刪掉 ",[21,176,162],{},"。它記錄",[30,179,182],{"href":180,"rel":181},"https:\u002F\u002Fdocs.npmjs.com\u002Fcli\u002Fv11\u002Fconfiguring-npm\u002Fpackage-lock-json\u002F",[87],"確切的相依套件版本","，刪掉後，下次安裝取得的版本可能改變。",[36,185,187],{"id":186},"用指令清理-npm-快取","用指令清理 npm 快取",[11,189,190],{},"Windows 開啟 PowerShell，macOS 開啟「終端機」，先查目前的快取位置：",[192,193,198],"pre",{"className":194,"code":195,"language":196,"meta":197,"style":197},"language-bash shiki shiki-themes github-light github-dark","npm config get cache\n","bash","",[21,199,200],{"__ignoreMap":197},[201,202,205,209,213,216],"span",{"class":203,"line":204},"line",1,[201,206,208],{"class":207},"sScJk","npm",[201,210,212],{"class":211},"sZZnC"," config",[201,214,215],{"class":211}," get",[201,217,218],{"class":211}," cache\n",[11,220,221,222,227,228,231,232,235],{},"這個指令只會",[30,223,226],{"href":224,"rel":225},"https:\u002F\u002Fdocs.npmjs.com\u002Fcli\u002Fv11\u002Fcommands\u002Fnpm-config\u002F",[87],"讀取設定","，不會刪除檔案。預設通常是 Windows 的 ",[21,229,230],{},"%LocalAppData%\\npm-cache","，或 macOS 的 ",[21,233,234],{},"~\u002F.npm","。把顯示的路徑放到檔案總管或 Finder 開啟，就能查看資料夾大小。",[11,237,238],{},"想先檢查快取，並回收其中不再需要的資料，可以執行：",[192,240,242],{"className":194,"code":241,"language":196,"meta":197,"style":197},"npm cache verify\n",[21,243,244],{"__ignoreMap":197},[201,245,246,248,251],{"class":203,"line":204},[201,247,208],{"class":207},[201,249,250],{"class":211}," cache",[201,252,253],{"class":211}," verify\n",[11,255,256],{},[17,257,258,261],{},[21,259,260],{},"verify"," 不只是檢查，也會整理無用的快取資料；它不是強制清空快取的指令。",[11,263,264],{},"確定需要騰出這部分空間，而且之後能重新下載套件，再等進行中的套件安裝和相關工作結束，執行：",[192,266,268],{"className":194,"code":267,"language":196,"meta":197,"style":197},"npm cache clean --force\n",[21,269,270],{"__ignoreMap":197},[201,271,272,274,276,279],{"class":203,"line":204},[201,273,208],{"class":207},[201,275,250],{"class":211},[201,277,278],{"class":211}," clean",[201,280,282],{"class":281},"sj4cs"," --force\n",[11,284,285,286,289,290,68],{},"這會刪除 npm 下載快取，不會移到資源回收筒或垃圾桶。npm 要求加上 ",[21,287,288],{},"--force","，是因為快取通常能自行處理完整性問題，不需要頻繁清空。詳細行為可參考 ",[30,291,294],{"href":292,"rel":293},"https:\u002F\u002Fdocs.npmjs.com\u002Fcli\u002Fv11\u002Fcommands\u002Fnpm-cache\u002F",[87],"npm cache 官方文件",[11,296,297],{},"清完之後，下次安裝可能變慢，而不是變快。如果接下來要離線工作，或目前無法重新下載私有套件，就先保留快取。快取不能當備份，但也沒必要為了例行清理而刪掉還用得上的資料。",[36,299,301],{"id":300},"空間還是不夠看看舊專案占了多少","空間還是不夠？看看舊專案占了多少",[11,303,304,305,307],{},"下載快取清掉後，各個專案的 ",[21,306,23],{}," 還在。因此，就算清理成功，也不一定能騰出很多空間。",[11,309,310,311,315],{},"這時可以切換到 MangoDisk 的",[30,312,314],{"href":313},"\u002Ftw\u002Fdocs\u002Ffeatures\u002Fdisk-analysis","磁碟空間分析","，選擇存放專案的磁碟或資料夾。矩形圖的方塊越大，占用就越多；點進去能繼續比較裡面的資料夾，不用逐個專案開啟內容視窗查大小。",[11,317,318],{},[51,319],{"alt":320,"decoding":54,"height":55,"loading":56,"src":321,"width":58},"MangoDisk 磁碟空間分析用目錄清單和矩形圖呈現資料夾大小","https:\u002F\u002Fassets.mangodisk.app\u002Fimages\u002Fscreenshots\u002Fwindows\u002Ftw\u002Flight-05-disk-space-analysis.jpg",[11,323,324,325,328],{},"如果占用最多的確實是暫時不用的相依套件，可以回到深度清理，檢查支援清理的專案建置產物。",[17,326,327],{},"刪除專案相依套件和清 npm 下載快取，是兩種不同的操作。"," 前者清掉後，再執行專案就需要重新安裝；原始碼、鎖定檔，以及自己改過的套件內容要先保留好。近期還在用的專案，不必為了騰空間反覆重裝。",[11,330,331,332,68],{},"資料夾很大，不代表就可以刪除。在磁碟空間分析中手動刪除會永久移除檔案，不經過資源回收筒或垃圾桶。不確定用途的先保留，詳見",[30,333,335],{"href":334},"\u002Ftw\u002Fdocs\u002Fsafety","安全清理指南",[36,337,338],{"id":338},"把各種快取放在一起比較",[11,340,341],{},"只清一份 npm 快取，用指令就能完成。想順便看看其他工具、舊專案留下多少檔案，MangoDisk 會更方便：在同一個畫面比較大小，再挑出值得清理的項目。",[11,343,344,347],{},[30,345,346],{"href":32},"下載 MangoDisk","，先掃描看看。免費開源，支援 Windows 和 macOS，不必註冊或登入；本文的掃描與清理都在本機完成，不需要啟用 AI。",[11,349,350,351,355,356],{},"延伸閱讀：",[30,352,354],{"href":353},"\u002Ftw\u002Fblog\u002Fcodex-disk-usage","整理 Codex 的磁碟占用"," · ",[30,357,359],{"href":358},"\u002Ftw\u002Fblog\u002Fcargo-cache-vs-target-folder","Cargo 快取和 target 資料夾，哪些可以刪？",[361,362,363],"style",{},"html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}",{"title":197,"searchDepth":365,"depth":365,"links":366},2,[367,368,369,370,371],{"id":38,"depth":365,"text":39},{"id":75,"depth":365,"text":76},{"id":186,"depth":365,"text":187},{"id":300,"depth":365,"text":301},{"id":338,"depth":365,"text":338},"開發者磁碟清理","\u002Fimages\u002Fblog\u002Fclean-npm-cache.webp","橘色刷子清走筆電旁散落的快取方塊，另一側的專案資料夾保持完整","npm 快取占用太多空間？用 MangoDisk 查看大小並清理下載快取，或使用 npm 指令處理。一次分清快取與 node_modules，不必刪除原始碼或重裝相依套件。",false,"md",{},true,"\u002Ftw\u002Fblog\u002Fclean-npm-cache","2026-09-16T14:40:00+08:00",{"title":5,"description":375},"tw\u002Fblog\u002Fclean-npm-cache",[385,23,386],"npm 快取清理","開發工具快取","article-clean-npm-cache","Q3O3exn67B8be8kVZ9LxpBOPcDyb3V-OB5ggk1TRgYk",1789637177637]