跳到内容
文档错误安装 `sharp` 以使用内置图像优化

安装 `sharp` 以使用内置图像优化

为什么会出现此错误

使用 Next.js 内置的图像优化需要sharp作为依赖项。

您看到此错误是因为您的操作系统无法正确安装 sharp,无论是使用预构建二进制文件还是从源代码构建。

可能的修复方法

选项 1:使用不同版本的 Node.js 并尝试再次安装 sharp

终端
npm i sharp
终端
yarn add sharp
终端
pnpm add sharp
终端
bun add sharp

选项 2:尝试通过运行 npm install --cpu=wasm32 sharp 安装 sharp 的 wasm 变体。

选项 3:如果使用 macOS,请确保已安装 XCode 构建工具并尝试再次安装 sharp

例如,请参阅macOS Catalina 说明

选项 4:使用不同的操作系统并尝试再次安装 sharp

例如,如果您使用的是 Windows,请尝试使用WSL(适用于 Linux 的 Windows 子系统)。