元数据文件 API 参考

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

每个文件约定既可以使用静态文件（如 opengraph-image.jpg）定义，也可以使用动态变体通过代码生成文件（如 opengraph-image.js）。

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

须知:

• 特殊路由处理器如 sitemap.ts、opengraph-image.tsx 和 icon.tsx 以及其他元数据文件默认会被缓存。
• 如果与 middleware.ts 同时使用，请配置匹配器以排除元数据文件。