Mac M1环境下安装sharp模块失败求助

针对ARM架构（如M1/M2系列Mac）上sharp模块安装失败的问题，可按以下步骤解决：

• 清理项目依赖与缓存

  rm -rf node_modules
  rm yarn.lock
  yarn cache clean
  

• 配置sharp预编译包镜像
  在项目根目录创建或编辑.npmrc文件，添加以下内容：

  SHARP_DIST_BASE_URL="https://npmmirror.com/mirrors/sharp-libvips/"
  SHARP_SKIP_DOWNLOAD_MANAGER=true
  

  也可直接在终端临时设置环境变量后安装：

  SHARP_DIST_BASE_URL=https://npmmirror.com/mirrors/sharp-libvips/ yarn add sharp
  

• 强制ARM架构编译
  关闭Rosetta转译的终端，直接用原生ARM终端执行：

  npm_config_arch=arm64 yarn install
  

• 验证安装结果
  执行以下命令确认sharp安装成功：

  npx sharp --version
  

  之后再运行yarn dev启动服务器。

sharp安装失败核心原因是ARM架构需要对应版本的libvips预编译二进制包，默认下载源可能无法获取适配文件，通过指定镜像或强制ARM架构编译可解决该问题。全局安装sharp无法解决项目内的依赖问题，需针对项目本地依赖进行处理。

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