Astroを使っていてCould not find Sharp.エラーが出た時の対処法

公開日:
目次

Astroを使っていて「Could not find Sharp.」というエラーに対処したので備忘録です。

エラーの概要

Astroでビルド時に2種類のエラーが出ました。

このエラーは通常、Astroプロジェクトで画像の最適化を行おうとした際に発生し、Sharpライブラリが見つからないことが原因です。

解決方法

そのままですが、Sharpライブラリが見つからないというエラーなので、Sharpをインストールすることで解決できます。

以下の手順に従って進めてください。

  1. まず、Sharpをプロジェクトにインストールしましょう。

pnpm:

pnpm add sharp

npm:

npm install sharp

yarn:

yarn add sharp
  1. astro.config.mjsファイルで、Sharpが正しく設定されているか確認します。
# astro.config.mjs
import { defineConfig } from 'astro/config';

export default defineConfig({
    image: {
        service: { entrypoint: 'astro/assets/services/sharp' },
    },
});
  1. もし上記の手順で解決しない場合は、キャッシュをクリアしてみましょう。

pnpm:

pnpm store prune

npm: