文档的这一部分涵盖了元数据文件约定。基于文件的元数据可以通过向路由段添加特殊的元数据文件来定义。
每个文件约定都可以通过使用静态文件(例如 opengraph-image.jpg),或者使用代码生成文件的动态变体(例如 opengraph-image.js)来定义。
文件定义后,Next.js 将自动提供该文件(在生产环境中会带哈希值以进行缓存),并使用正确的元数据更新相关的头部元素,例如资产的 URL、文件类型和图片大小。
须知:
- 特殊的路由处理程序,例如
sitemap.ts、opengraph-image.tsx和icon.tsx,以及其他元数据文件默认情况下是会被缓存的。- 如果与
proxy.ts一起使用,请配置匹配器以排除元数据文件。