JS 中 npm 依赖缓存机制（npm cache）怎么清理与排查-js教程-PHP中文网

npm缓存是基于cacache的内容可寻址存储系统，位于~/.npm/_cacache（macOS/Linux）或%LocalAppData%\npm-cache（Windows），含content-v2、index-v5和tmp三个关键子目录；仅当出现EPERM、integrity校验失败或升级后异常时才需清理，推荐执行npm cache verify→clean --force→手动删tmp→再verify验证。

js 中 npm 依赖缓存机制（npm cache）怎么清理与排查

npm 缓存不是“装了就能用”的黑盒，它是一套基于 cacache 的内容可寻址存储系统，出问题时不能只靠 rm -rf node_modules。真正有效的清理和排查，得从缓存结构、错误类型、操作节奏三方面入手。

缓存到底存在哪？先定位再动手

npm 缓存默认路径由 npm config get cache 决定：

macOS / Linux：~/.npm/_cacache
Windows：%AppData%\npm-cache（实际指向 %LocalAppData%\npm-cache）

这个 _cacache 目录不是普通文件夹——它包含三个关键子目录：

content-v2：所有包的压缩包（tarball）按 SHA-512 哈希值命名存放，相同内容只存一份
index-v5：记录哪个哈希对应哪个包名+版本，是“索引表”
tmp：临时解压、校验、写入时的中转区，EPERM 错误 90% 发生在这里

什么时候必须清？别乱清

缓存本身不损坏就无需清理。以下情况才建议干预：

arcgis-js

提供 ArcGIS Maps SDK for JavaScript 开发辅助，涵盖 2D/3D 地图视图、图层管理、数据可视化、空间分析等功能模块的参考和示例指导。

下载

执行 npm install 报 EPERM: operation not permitted（尤其 Windows 上错误码 -4048）
反复出现 integrity checksum failed 或 unexpected end of file
磁盘空间告急，且 npm cache verify 显示 “garbage collected” 数量异常高（比如 >30%）
升级 Node.js 或 npm 后，多个项目突然安装失败

安全清理四步法（比 --force 更稳）

直接 npm cache clean --force 能清空，但可能跳过验证，也清不掉被进程锁住的 tmp 文件。推荐分步操作：

停掉所有正在运行的 npm、Node 进程，关掉 VS Code 等可能扫描 node_modules 的 IDE
运行 npm cache verify：查看当前缓存健康度，重点关注 Duplicate requests 和 Garbage collected 行
执行 npm cache clean --force，它会清空 content-v2 和 index-v5，但通常留着 tmp（因可能被占用）
手动进入缓存路径，删除整个 tmp 文件夹（Windows 下若提示占用，用资源监视器查 node.exe 或 Code.exe 并结束）

清理后怎么验证是否真好了？

别只看命令没报错。做完清理，务必做两件事：

再跑一次 npm cache verify：输出应显示 Content verified 接近 Index entries，且 Garbage collected 为 0
新建测试项目验证流程：
```
mkdir test-cache && cd test-cache<br>
npm init -y<br>
npm install lodash@4.17.21 --no-save<br>
npm cache verify
```
如果这三步都快、无报错、verify 输出干净，说明缓存已回归正常状态