元数据文件 API 参考

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

¥This section of the docs covers Metadata file conventions. File-based metadata can be defined by adding special metadata files to route segments.

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

¥Each file convention can be defined using a static file (e.g. opengraph-image.jpg), or a dynamic variant that uses code to generate the file (e.g. opengraph-image.js).

定义文件后，Next.js 将自动提供该文件（使用生产中的哈希值进行缓存）并使用正确的元数据更新相关的头元素，例如资源的 URL、文件类型和图片大小。

¥Once a file is defined, Next.js will automatically serve the file (with hashes in production for caching) and update the relevant head elements with the correct metadata, such as the asset's URL, file type, and image size.

很高兴知道：

¥Good to know:

• 默认情况下会缓存特殊路由处理程序（如 sitemap.ts、opengraph-image.tsx 和 icon.tsx）和其他 元数据文件。

  ¥Special Route Handlers like sitemap.ts, opengraph-image.tsx, and icon.tsx, and other metadata files are cached by default.

• 如果与 middleware.ts、配置匹配器 一起使用以排除元数据文件。

  ¥If using along with middleware.ts, configure the matcher to exclude the metadata files.