元数据文件 API 参考

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

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

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

须知:

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