运行npm install或yarn install时出现Zlib错误该如何解决
2026-10-1
解决方案
方案1：更换Node.js版本（优先推荐）
你当前使用的Node.js v14.18.0在MacOS Big Sur上存在已知的zlib库编译缺陷，是导致该报错的最常见原因。
可通过nvm工具切换到无该问题的Node版本，操作命令如下：
# 安装v14.17.6（v14分支的稳定无bug版本） nvm install 14.17.6 # 切换到该版本 nvm use 14.17.6 # 验证版本 node -v
版本切换完成后，重新执行yarn install或npm install即可。
方案2：更换依赖安装源
部分情况下包下载过程中传输损坏会导致校验失败，可临时使用国内镜像源安装：
- yarn安装命令：
yarn install --registry https://registry.npmmirror.com - npm安装命令：
npm install --registry https://registry.npmmirror.com
方案3：全量清理缓存后重试
如果之前的缓存存在损坏的包文件，可执行全量清理操作：
- 删除项目下的node_modules目录：
rm -rf node_modules - 删除项目下的锁文件：
rm -rf yarn.lock package-lock.json - 清理yarn全局缓存：
yarn cache clean - 清理npm全局缓存：
npm cache clean --force
清理完成后重新执行安装命令。
方案4：关闭网络代理重试
如果当前设备开启了系统代理或VPN，可能会篡改下载的包内容导致校验失败，关闭代理后重新执行安装操作即可。
内容的提问来源于stack exchange，提问作者Nilton Schumacher F
相关产品推荐
相关产品推荐
