Knowledge Garden
トラブルシュート 公開日

Pagefind の検索結果が出ないとき

Astro サイトで Pagefind の検索 UI は出るが結果が表示されない場合の確認ポイント。

Pagefind はビルド後の静的ファイルを読み取って検索インデックスを作ります。開発サーバーだけを起動している状態では、インデックスが存在しないため結果が表示されません。

症状

  • 検索入力は表示される
  • 入力しても結果が出ない
  • /pagefind/pagefind-ui.js が見つからない

確認すること

  1. npm run build を実行しているか
  2. postbuildpagefind --site dist が走っているか
  3. 確認時に npm run preview を使っているか
  4. 検索対象のページに data-pagefind-body が付いているか

このサイトでは検索ページ自体は data-pagefind-ignore にし、本文ページだけを検索対象にしています。