[{"data":1,"prerenderedAt":317},["ShallowReactive",2],{"blog-article-\u002Ftw\u002Fblog\u002Fdelete-old-node-modules":3},{"id":4,"title":5,"author":6,"body":7,"category":297,"cover":298,"coverAlt":299,"description":300,"draft":301,"extension":302,"meta":303,"navigation":304,"path":305,"publishedAt":306,"seo":307,"stem":308,"tags":309,"topics":313,"translationKey":315,"updatedAt":306,"__hash__":316},"articles_tw\u002Ftw\u002Fblog\u002Fdelete-old-node-modules.md","如何清理舊專案的 node_modules，釋放磁碟空間","Harry",{"type":8,"value":9,"toc":289},"minimark",[10,24,32,37,49,60,69,72,110,113,117,120,123,126,166,169,173,185,191,204,208,214,220,242,253,256,259,263,266,274,285],[11,12,13,14,18,19,23],"p",{},"以前做的網站、練習用的範例專案，即使已經沒在使用，裡面的 ",[15,16,17],"code",{},"node_modules"," 還是會佔用空間。",[20,21,22],"strong",{},"確認專案暫時用不到，而且之後能重新安裝套件，就可以刪除這部分相依套件資料夾，保留原始碼。"," 下次要執行專案時，需要先把套件裝回來。",[11,25,26,31],{},[27,28,30],"a",{"href":29},"\u002Ftw","MangoDisk"," 支援掃描專案的相依套件與建置產物，將找到的路徑和大小集中列出。你可以確認各個資料夾屬於哪個專案，再決定要移除哪些，不必逐一打開舊專案查看大小。",[33,34,36],"h2",{"id":35},"用-mangodisk-找出舊專案的相依套件","用 MangoDisk 找出舊專案的相依套件",[11,38,39,40,44,45,48],{},"開啟",[27,41,43],{"href":42},"\u002Ftw\u002Fdocs\u002Ffeatures\u002Fdeep-clean","深度清理","，先執行掃描。如果專案放在其他磁碟，點選掃描按鈕旁的下拉箭頭，進入",[20,46,47],{},"選擇磁碟","，將對應磁碟加入掃描範圍。",[11,50,51],{},[52,53],"img",{"alt":54,"decoding":55,"height":56,"loading":57,"src":58,"width":59},"MangoDisk 在 macOS 的深度清理畫面，顯示清理類別、使用者快取明細與選取控制項","async",1263,"lazy","https:\u002F\u002Fassets.mangodisk.app\u002Fimages\u002Fscreenshots\u002Ftw\u002Flight-01-deep-cleanup.jpg",1964,[11,61,62,65,66,68],{},[20,63,64],{},"專案相依套件清理會直接刪除所選內容，不會移至垃圾桶或資源回收筒。"," 如果曾直接修改 ",[15,67,17],{}," 裡的檔案，請先備份這些變更；重新安裝套件不會還原手動修改的內容。",[11,70,71],{},"掃描完成後，依序檢查：",[73,74,75,83,94,97,103],"ol",{},[76,77,78,79,82],"li",{},"在底部的選擇方式選單中選擇",[20,80,81],{},"全部取消選取","，先清除目前的勾選，方便只處理這次要整理的內容。",[76,84,85,86,89,90,93],{},"找到",[20,87,88],{},"專案建置產物","，展開 ",[20,91,92],{},"Node.js 建置產物","。",[76,95,96],{},"比較明細中的路徑和大小，找出暫時不使用的專案。名稱相近時，開啟所在資料夾確認，不要只憑名稱或大小決定。",[76,98,99,100,102],{},"只勾選確認要移除的 ",[15,101,17],{}," 資料夾，保留還在使用的專案。同一類別也可能列出框架建置快取，不必整組全部選取。",[76,104,105,106,109],{},"停止相關專案的開發伺服器、建置及套件安裝作業，確認所選路徑與預估可釋放的空間，再點選",[20,107,108],{},"清理","並確認。",[11,111,112],{},"MangoDisk 幫你找出分散的相依套件資料夾，方便比較與選擇。哪些專案可以暫時收起來，仍由你決定；資料夾很大，不代表它已經沒用。",[33,114,116],{"id":115},"哪些專案適合先清理","哪些專案適合先清理？",[11,118,119],{},"可以先從已經告一段落、只想保留原始碼的專案開始，例如做完的教學範例、不再維護的舊網站，或試過之後擱置的原型。",[11,121,122],{},"正在開發、近期需要展示，或接下來要離線使用的專案，可以先保留。刪除相依套件後，通常需要重新安裝才能執行或建置，反而可能打斷接下來的工作。",[11,124,125],{},"清理前，確認以下內容都留在專案裡：",[127,128,129,135,156],"ul",{},[76,130,131,134],{},[20,132,133],{},"原始碼與素材","：自己寫的程式碼、網頁、圖片及其他專案檔案。",[76,136,137,140,141,144,145,148,149,152,153,93],{},[20,138,139],{},"套件清單與鎖定檔","：",[15,142,143],{},"package.json","，以及專案使用的 ",[15,146,147],{},"package-lock.json","、",[15,150,151],{},"pnpm-lock.yaml"," 或 ",[15,154,155],{},"yarn.lock",[76,157,158,161,162,165],{},[20,159,160],{},"執行設定與本機資料","：例如 ",[15,163,164],{},".env","、本機資料庫，以及尚未備份的上傳檔案。",[11,167,168],{},"如果套件來自私人套件庫、公司內部來源，或專案使用較舊的執行環境，先確認之後仍能安裝。不確定的專案就先留著，不必一次全部清完。",[33,170,172],{"id":171},"刪除-node_modules也會清掉-npm-快取嗎","刪除 node_modules，也會清掉 npm 快取嗎？",[11,174,175,176,178,179,93],{},"這是兩種不同的清理。",[15,177,17],{}," 放的是專案已安裝的相依套件；npm 下載快取則保留可重複使用的套件資料，兩者通常存放在不同位置。可參考 ",[27,180,184],{"href":181,"rel":182},"https:\u002F\u002Fdocs.npmjs.com\u002Fcli\u002Fv11\u002Fconfiguring-npm\u002Ffolders\u002F",[183],"nofollow","npm 官方目錄說明",[11,186,187,188,190],{},"因此，清除 npm 快取後，舊專案的相依套件資料夾仍可能佔用空間；只刪除某個專案的 ",[15,189,17],{},"，也不會順便清空 npm 下載快取。",[11,192,193,194,198,199,203],{},"如果想處理的是下載資料，可以另外查看 ",[27,195,197],{"href":196},"\u002Ftw\u002Fblog\u002Fclean-npm-cache","npm 快取清理方法","。使用 pnpm 時，也應將",[27,200,202],{"href":201},"\u002Ftw\u002Fblog\u002Fclear-pnpm-store-cache","共用儲存空間的整理","與專案相依套件清理分開考慮。",[33,205,207],{"id":206},"之後還想執行專案如何裝回套件","之後還想執行專案，如何裝回套件？",[11,209,210,211,213],{},"回到專案根目錄，也就是放著 ",[15,212,143],{}," 的位置，按照專案原本的安裝說明恢復相依套件。",[11,215,216,217,219],{},"使用 npm 且保留相符 ",[15,218,147],{}," 的專案，通常可以執行：",[221,222,227],"pre",{"className":223,"code":224,"language":225,"meta":226,"style":226},"language-bash shiki shiki-themes github-light github-dark","npm ci\n","bash","",[15,228,229],{"__ignoreMap":226},[230,231,234,238],"span",{"class":232,"line":233},"line",1,[230,235,237],{"class":236},"sScJk","npm",[230,239,241],{"class":240},"sZZnC"," ci\n",[11,243,244,245,247,248,93],{},"這會依鎖定檔重新安裝套件；如果還有 ",[15,246,17],{},"，會先將其移除。套件清單與鎖定檔不一致時，指令會回報錯誤，不要為了完成安裝就刪除鎖定檔。詳見 ",[27,249,252],{"href":250,"rel":251},"https:\u002F\u002Fdocs.npmjs.com\u002Fcli\u002Fv11\u002Fcommands\u002Fnpm-ci\u002F",[183],"npm ci 官方說明",[11,254,255],{},"原本使用 pnpm 或 Yarn 的專案，請繼續使用原來的工具與安裝說明，避免任意改用 npm，產生另一套鎖定檔。安裝過程可能需要下載套件及編譯元件，完成後再嘗試啟動專案。",[11,257,258],{},"如果安裝失敗，先確認專案要求的 Node.js 版本、套件來源及帳號權限。清理相依套件不會補齊這些執行條件，也不保證所有舊專案都能立即恢復運作。",[33,260,262],{"id":261},"清理後確認磁碟空間是否增加","清理後，確認磁碟空間是否增加",[11,264,265],{},"完成後先查看 MangoDisk 的清理結果與磁碟可用空間。若部分資料夾未能處理，依結果提示確認原因；仍在使用的專案先停止執行，確認後再試。",[11,267,268,269,273],{},"如果相依套件資料夾已經清掉，磁碟卻還是很滿，可以用",[27,270,272],{"href":271},"\u002Ftw\u002Fdocs\u002Ffeatures\u002Fdisk-analysis","磁碟空間分析","查看專案裡還有什麼佔用空間，例如影片素材、資料集或匯出的檔案。這些內容需要分別判斷，不能把整個專案資料夾當成相依套件一起刪除。",[11,275,276,280,281,93],{},[27,277,279],{"href":278},"\u002Ftw\u002Fdownload","下載 MangoDisk","，先掃描看看舊專案留下了多少相依套件。保留之後可能繼續使用的程式碼，按需清理暫時用不到、可以重新安裝的部分。其他相關整理方式可見",[27,282,284],{"href":283},"\u002Ftw\u002Fblog\u002Ftopics\u002Fdeveloper-cleanup","開發者清理指南",[286,287,288],"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);}",{"title":226,"searchDepth":290,"depth":290,"links":291},2,[292,293,294,295,296],{"id":35,"depth":290,"text":36},{"id":115,"depth":290,"text":116},{"id":171,"depth":290,"text":172},{"id":206,"depth":290,"text":207},{"id":261,"depth":290,"text":262},"開發者磁碟清理","\u002Fimages\u002Fblog\u002Fdelete-old-node-modules.webp","專案資料夾內保留文件，橙色刷子掃開旁邊可拆卸的套件積木","舊專案的 node_modules 佔用太多空間？用 MangoDisk 集中查看相依套件資料夾的路徑與大小，保留原始碼和鎖定檔，再移除暫時不需要、之後能重新安裝的套件。",false,"md",{},true,"\u002Ftw\u002Fblog\u002Fdelete-old-node-modules","2026-11-16T13:56:58+08:00",{"title":5,"description":300},"tw\u002Fblog\u002Fdelete-old-node-modules",[310,311,312],"node_modules 清理","刪除舊專案相依套件","專案佔用空間",[314],"developer-cleanup","article-delete-old-node-modules","owapa2PhOWIvfJQ_kc28N758FCbm_24FEwc_P9Swzxw",1794875701101]