升级Node和Yarn至最新版本后执行yarn install时sharp@0.29.3构建失败求助

我之前帮不少开发者排查过sharp包的构建问题，结合你当前的环境（Node v20.9.0 + Yarn v3.5.0 + sharp@0.29.3），大概率是版本兼容性或者缓存/系统依赖的问题，给你整理几个实用的解决步骤，你可以按顺序试试：

• 优先升级sharp到适配Node 20的版本：sharp@0.29.x版本的官方支持范围是Node.js 12~18，并不兼容Node 20。从sharp@0.31.0开始才正式支持Node 20，你可以把package.json里的sharp依赖改成^0.31.0（或更高的稳定版本），然后重新执行yarn install。升级后大部分基础图片处理API都是兼容的，要是项目里用到了一些小众API，可以先查下官方的版本变更文档确认。

• 清理Yarn缓存与依赖残留：Yarn 3的缓存有时候会残留旧的构建失败文件，导致重复报错。你可以按以下步骤操作：

  1. 执行yarn cache clean清理Yarn全局缓存
  2. 删除项目根目录的node_modules文件夹（Windows用rmdir /s /q node_modules，Linux/macOS用rm -rf node_modules）
  3. 删除yarn.lock文件
  4. 重新运行yarn install

• 检查并安装sharp所需的系统依赖：sharp依赖系统级的libvips库，缺少它也会导致构建失败：

  • Windows用户：可以尝试安装Windows Build Tools（执行npm install --global windows-build-tools，注意要以管理员身份运行终端），或者在项目根目录创建.yarnrc.yml文件，添加配置强制使用预编译的二进制包：

    packageExtensions:
      sharp@*:
        dependencies:
          sharp-libvips: "^8.13.3"
    

  • Linux/macOS用户：直接安装系统级的libvips开发包，比如Ubuntu用sudo apt-get install libvips-dev，macOS用brew install vips

• 查看详细构建日志定位精准问题：你可以打开报错里提到的D:\TEMP\xfs-6da33975\build.log，里面会有更具体的错误提示——比如是不是缺少某个Node模块、系统库找不到，或者权限不足，根据日志信息能更快锁定问题根源。

备注：内容来源于stack exchange，提问作者Horkos