MacBook M1执行npm install报错Z_DATA_ERROR zlib数据校验错误求助

问题根因 #

你遇到的zlib: incorrect data check报错和项目ESLint配置完全无关，属于Apple M1芯片与旧版Node.js内置zlib模块的兼容性问题，仅在npm解压特定依赖包时触发。你之前使用的v14.16版本未完全适配M1架构，Node官方在v14.17.0版本才正式加入Apple Silicon原生支持，本次新增ESLint相关依赖时触发了该底层兼容问题。

可行解决方案 #

按优先级依次尝试：

• 升级Node v14版本到最新LTS版（原生适配M1）
  执行以下命令安装适配M1的v14最新长期支持版本：

  nvm install 14 --lts
  nvm use 14
  

  安装完成后重新执行npm install即可。
• 使用Rosetta 2模式运行终端
  右键点击Finder中的「终端」应用，选择「显示简介」，勾选「使用Rosetta打开」，重启终端后再执行依赖安装命令。
• 更换npm镜像源避免下载包损坏
  切换为国内镜像源后清理缓存重装：

  npm config set registry https://registry.npmmirror.com
  npm cache clean --force
  rm -rf node_modules package-lock.json
  npm install
  

• 替换包管理器
  若上述方案均无效，可换用yarn/pnpm避开npm本身的解压逻辑问题：

  npm i -g yarn
  yarn install
  

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