元数据文件 API 参考

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

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

一旦定义了文件，Next.js 将自动提供该文件（在生产环境中带有哈希值以进行缓存），并使用正确的元数据更新相关的 head 元素，例如资产的 URL、文件类型和图像大小。

须知:

• 默认情况下，特殊路由处理程序（如 sitemap.ts、opengraph-image.tsx 和 icon.tsx）以及其他 元数据文件 都会被缓存。
• 如果与 middleware.ts 一起使用，请配置 matcher 以排除元数据文件。