元数据文件 API 参考

本文档部分涵盖了元数据文件约定。基于文件的元数据可以通过向路由段添加特殊的元数据文件来定义。

每种文件约定都可以使用静态文件 (例如 opengraph-image.jpg) 或使用代码生成文件的动态变体 (例如 opengraph-image.js) 来定义。

一旦定义了文件，Next.js 将自动提供该文件 (在生产环境中带有哈希值以便缓存)，并用正确的元数据更新相关的头部元素，如资源的 URL、文件类型和图像尺寸。

值得注意的是: 特殊的路由处理程序，如 sitemap.ts、opengraph-image.tsx 和 icon.tsx，以及其他元数据文件默认情况下都会被缓存。