安装sharp@0.18.2时npm抛出报错，求解决方案（附环境信息）

1. 检查并更新Xcode Command Line Tools #

MacOS下编译C++依赖需要对应版本的Xcode命令行工具，先执行安装/更新：

xcode-select --install

如果已安装，用以下命令检查并更新到最新兼容版本：

softwareupdate --list
softwareupdate --install "Command Line Tools for Xcode-xx.x" # 替换为列表里的最新版本号

2. 明确指定node-gyp使用的Python版本 #

sharp@0.18.2对Python版本有特定要求，直接给node-gyp指定你已安装的Python 3.9：

npm config set python python3.9

3. 清理缓存后重新安装 #

残留的缓存或依赖文件可能导致编译失败，先清理再重装：

npm cache clean --force
rm -rf node_modules package-lock.json
npm install sharp@0.18.2

4. 跳过本地编译，使用预编译二进制包 #

sharp提供预编译好的二进制文件，无需本地编译，设置环境变量后安装：

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install sharp@0.18.2

如果是网络问题导致无法拉取二进制包，可以切换国内镜像：

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 sharp@0.18.2

5. 调整node-gyp版本适配Node 12.x #

node-gyp 9.3.0虽支持Node 12，但部分场景下降级到8.x版本兼容性更好：

npm install -g node-gyp@8.4.1

之后重新执行sharp的安装命令。

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