中繼資料檔案 API 參考

本文件章節涵蓋中繼資料檔案慣例。您可以透過在路由區段 (route segments) 中加入特殊的中繼資料檔案，來定義基於檔案的中繼資料。

每個檔案慣例可以使用靜態檔案 (例如 opengraph-image.jpg) 或使用程式碼生成檔案的動態變體 (例如 opengraph-image.js) 來定義。

一旦定義了檔案，Next.js 會自動提供該檔案 (在生產環境中會加入雜湊值以利快取)，並使用正確的中繼資料更新相關的 head 元素，例如資源的 URL、檔案類型和圖片尺寸。

須知事項:

• 特殊路由處理器 (Route Handlers) 如 sitemap.ts、opengraph-image.tsx 和 icon.tsx，以及其他中繼資料檔案 預設會被快取。
• 如果同時使用 middleware.ts，請配置 matcher 來排除中繼資料檔案。