npm cache add <tgz> 无效求助：本地打包tgz无法加入缓存

我来帮你一步步排查这个问题，这种情况我在日常开发中碰到过好几次，通常是以下几个常见原因导致的：

1. 你检查错了缓存目录 #

很多人会误以为npm缓存存在项目根目录的.npm文件夹里，但默认情况下npm的全局缓存目录根本不在项目里：

• 在Linux/macOS上，默认路径是~/.npm
• 在Windows上，默认是%AppData%\npm-cache

你可以先执行npm config get cache命令，直接获取当前npm使用的缓存目录，然后去这个目录下查看，而不是项目里的.npm文件夹。

2. npm cache add的路径参数有误 #

先确认$tarball变量是否正确获取了打包后的文件名：

• 执行echo $tarball，看看输出是不是类似your-package-1.0.0.tgz这样的文件名
• 再确认$PWD/$tarball是不是正确的绝对路径，比如可以执行ls "$PWD/$tarball"，如果返回文件不存在的错误，那说明路径有问题，可能是npm pack没成功生成tarball，或者变量赋值出错

另外，其实npm cache add可以直接接收本地文件的相对路径，你可以简化命令试试：

tarball=$(npm pack)
npm cache add "./$tarball"

3. 权限问题导致无法写入缓存 #

如果你的全局缓存目录属于root用户（比如Linux/macOS上用sudo安装过npm），那么普通用户执行npm cache add时可能没有写入权限，导致缓存无法更新。

可以试试：

• 查看缓存目录的权限：ls -la $(npm config get cache)
• 如果确实是权限问题，可以用sudo npm cache add "$PWD/$tarball"（不推荐长期用sudo，最好是修复npm的权限配置），或者修改缓存目录的所有者：sudo chown -R $USER $(npm config get cache)

4. npm缓存处于禁用或特殊模式 #

如果你的npm配置里禁用了缓存，或者设置了特殊的缓存模式，也会导致npm cache add不生效：

• 执行npm config get cache-min和npm config get cache-max，看看是不是设置了极端值（比如cache-min设为0或者很大的数）
• 检查是否有--no-cache参数被全局配置，执行npm config get cache如果返回空或者特殊值，可能是缓存被禁用了

5. tarball本身无效 #

如果npm pack生成的tarball有问题（比如文件损坏、不符合npm包规范），npm cache add可能会静默失败，不会写入缓存。

你可以先验证tarball的有效性：

npm view "$PWD/$tarball"

如果这个命令返回错误信息，说明你的tarball有问题，需要先排查npm pack的执行是否正常，比如检查package.json是否有语法错误，或者项目里有没有不符合npm规范的文件。

内容的提问来源于stack exchange，提问作者user7898461