运行Node项目时出现Sharp命令执行失败退出码1如何解决

你遇到的sharp安装报错核心是安装时无法下载依赖的libvips二进制包，或是系统缺少编译所需的基础依赖导致编译失败，可按以下步骤逐一排查解决：

1. 清理受损依赖与缓存 #

首先删除已经安装失败的依赖文件和缓存，避免残留文件干扰后续安装：

• 删除node_modules文件夹与依赖锁文件

rm -rf node_modules yarn.lock package-lock.json

• 清理包管理工具缓存

# 使用npm的用户执行
npm cache clean --force
# 使用yarn的用户执行
yarn cache clean

2. 配置国内Sharp镜像（国内环境必做） #

国内网络环境下默认无法正常下载sharp所需的libvips二进制文件，配置镜像后再安装依赖即可解决：

# npm用户执行
npm config set sharp_binary_host "https://npmmirror.com/mirrors/sharp"
npm config set sharp_libvips_binary_host "https://npmmirror.com/mirrors/sharp-libvips"
npm install

# yarn用户执行
yarn config set sharp_binary_host "https://npmmirror.com/mirrors/sharp"
yarn config set sharp_libvips_binary_host "https://npmmirror.com/mirrors/sharp-libvips"
yarn install

3. Linux/WSL环境补充系统依赖 #

如果你是在Linux系统或者WSL子系统中运行项目，缺少基础编译依赖也会触发该报错，先安装系统级依赖：

# Debian/Ubuntu系（包含WSL默认的Ubuntu发行版）
sudo apt update
sudo apt install -y build-essential libvips-dev libpng-dev libjpeg-dev glib2.0-dev

系统依赖安装完成后，再重新执行依赖安装命令即可。

4. 版本兼容排查 #

如果上述步骤执行后仍报错，检查你的Node.js版本与项目中sharp的版本是否匹配：

• Node.js 16及以上版本推荐使用sharp@0.30.0+版本
• Node.js 14及以下版本推荐使用sharp@0.29.x版本
  修改package.json中sharp的版本号后重新安装依赖即可。

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