You need to enable JavaScript to run this app. 指定.npm缓存路径离线优先安装后,缓存与node_modules体积差是否说明缓存失效
优惠活动
大模型
产品
解决方案
定价
更多

指定.npm缓存路径离线优先安装后,缓存与node_modules体积差是否说明缓存失效

结论前置

别直接用两个目录的大小差算下载量,这个判断从根上就错了——这俩目录存的东西完全不是一回事,不能直接拿数值相减。

最容易踩的存储逻辑坑

你用--cache指定的目录,本质是npm存原始压缩tgz安装包的地方,也就是你从registry拉下来的没拆封的安装包,没有任何解压、编译、处理后的内容。
而node_modules是什么?是所有包拆封、跑安装脚本、编译完的最终运行文件,里面带着源码、类型声明、sourcemap、对应你系统平台的二进制、甚至连测试文件、文档都在,体积膨胀个3-5倍是家常便饭。
举个最常见的例子:esbuild的对应平台tgz包才十几M,拆完带可执行文件、类型映射后直接能涨到30M以上;整个前端项目的依赖堆起来,原始tgz总大小两三百M、解压完node_modules到1G+,是非常普遍的情况,根本不能说明“多下了900M没进缓存”。

别靠大小猜,直接验证缓存生不生效

想知道缓存有没有用,别算差值,跑这几个操作一眼就能看出来:

  • 装依赖的时候加详细日志参数:
    npm install --cache /tmp/node-cache/.npm --prefer-offline --loglevel verbose
    
    日志里打from cache /tmp/...的,就是走了本地缓存根本没下公网;打downloading tarball/fetching manifest的,才是真的从公网拉东西,这些拉下来的tarball默认是一定会写进你指定的缓存目录的,根本不会漏。
  • 做个对照测试:别删现有缓存,连续跑两次一模一样的install,跑完分别看下.npm目录的大小。要是第二次跑完缓存大小几乎不涨,说明第一次装的时候所有需要下载的内容就已经正常存进缓存了,不存在漏存。

为啥有时候看起来缓存没涨、体积差很大

很多时候你觉得“东西没进缓存”,根本不是npm缓存逻辑出问题,是你没算到这几个场景:

  • 这次装的依赖版本和上次缓存的版本对不上,本来就要下新版本的tgz,这部分本来就该算缓存的增量,不是漏存。
  • 像Electron、Puppeteer、Sharp这种带postinstall脚本的包,安装时会从第三方地址拉对应平台的二进制文件,这部分下载根本不走npm本身的流程,自然不会存在.npm目录里——这部分本来就不算npm缓存要管的内容,你node_modules里这部分的体积,本来就和npm缓存没关系。
  • du统计的不是文件本身的总大小,是文件占的实际磁盘块数。node_modules里全是零散小文件,磁盘碎片占比高,实际占用会比文件总大小高不少;而npm缓存里都是大体积的连续tgz文件,碎片少,两个的统计值根本就没有直接做差的逻辑。

简单说:177M的压缩包缓存,解压出来1.1G的node_modules是完全正常的,不能直接推导出“有900M下载的东西没进缓存”的结论。

内容的提问来源于stack exchange,提问作者Vojtěch

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.11 02:27:01