コンテンツにスキップ
ドキュメントエラー組み込みの画像最適化を使用するために `sharp` をインストールする

組み込みの画像最適化を使用するために `sharp` をインストールする

このエラーが発生した理由

Next.js の組み込みの画像最適化を使用するには、依存関係としてsharpが必要です。

このエラーが表示されるのは、OS が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 Build Tools がインストールされていることを確認し、sharp を再度インストールしてみてください。

たとえば、macOS Catalina の手順を参照してください。

オプション 4: 別の OS を使用し、sharp を再度インストールしてみてください。

たとえば、Windows を使用している場合は、WSL(Windows Subsystem for Linux)を使用してみてください。