Metadata 檔案 API 參考

文件的這個章節涵蓋了 Metadata 檔案命名慣例。基於檔案的 metadata 可以透過將特殊的 metadata 檔案新增到路由區段來定義。

每個檔案命名慣例都可以使用靜態檔案（例如 opengraph-image.jpg），或使用程式碼產生檔案的動態變體（例如 opengraph-image.js）來定義。

一旦定義了檔案，Next.js 將自動提供該檔案（在生產環境中會使用雜湊以進行快取），並使用正確的 metadata 更新相關的 head 元素，例如資源的 URL、檔案類型和圖片大小。

要知道:

• 特殊的路由處理器，例如 sitemap.ts、opengraph-image.tsx 和 icon.tsx，以及其他 metadata 檔案 預設會被快取。
• 如果與 middleware.ts 一起使用，設定 matcher 以排除 metadata 檔案。