[{"data":1,"prerenderedAt":317},["ShallowReactive",2],{"blog-article-\u002Fzh\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_zh\u002Fzh\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},"\u002Fzh","MangoDisk"," 支持扫描项目依赖和构建产物，把找到的目录及容量集中列出。你可以查看它们属于哪个项目，再选择要清理的部分，不用逐个打开旧项目查大小。",[33,34,36],"h2",{"id":35},"用-mangodisk-找到旧项目的依赖目录","用 MangoDisk 找到旧项目的依赖目录",[11,38,39,40,44,45,48],{},"打开",[27,41,43],{"href":42},"\u002Fzh\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 深度清理界面，展示清理分类、用户缓存明细与选择控件","async",1330,"lazy","https:\u002F\u002Fassets.mangodisk.app\u002Fimages\u002Fscreenshots\u002Fzh\u002Flight-01-deep-cleanup.jpg",2068,[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],{},"不会把两者一并清掉。",[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},"\u002Fzh\u002Fblog\u002Fclean-npm-cache","npm 缓存清理方法","。使用 pnpm 时，也应把",[27,200,202],{"href":201},"\u002Fzh\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],{},"这会按锁文件重新安装依赖；如果仍有 ",[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},"\u002Fzh\u002Fdocs\u002Ffeatures\u002Fdisk-analysis","磁盘空间分析","查看项目目录里还有什么占用，例如保存的视频素材、数据集或导出的文件。这些内容需要分别判断，不能把整个项目文件夹当成依赖一起删除。",[11,275,276,280,281,93],{},[27,277,279],{"href":278},"\u002Fzh\u002Fdownload","下载 MangoDisk","，先扫描看看旧项目留下了多少依赖。保留以后还想继续做的代码，把暂时用不到、能够重新安装的部分按需清理。 其他相关整理方法可见",[27,282,284],{"href":283},"\u002Fzh\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,"\u002Fzh\u002Fblog\u002Fdelete-old-node-modules","2026-11-16T13:56:58+08:00",{"title":5,"description":300},"zh\u002Fblog\u002Fdelete-old-node-modules",[310,311,312],"node_modules 清理","删除旧项目依赖","项目依赖占用空间",[314],"developer-cleanup","article-delete-old-node-modules","X81hmaYqpaDejOQNnV8ca0xKaw8YlHgFwdHK2EPy_r8",1794875701099]