Menu

部分预渲染（实验性）

部分预渲染是一个实验性功能，可能会发生变化。

部分预渲染是一个实验性功能，允许路由的静态部分被预渲染并从缓存中提供，同时动态部分通过流式传输进来，所有这些都在一个 HTTP 请求中完成。

Next.js 15 提供了增量支持，允许你为特定路由和布局选择加入部分预渲染。

要启用部分预渲染，请将实验性 ppr 标志设置为 incremental：

next.config.js
/** @type {import('next').NextConfig} */
const nextConfig = {
  experimental: {
    ppr: "incremental",
  },
};
 
module.exports = nextConfig;

选项

  • incremental：允许你逐步选择加入布局和页面，并应与 experimental_ppr 路由配置选项一起使用。
  • true：为应用程序中的所有路由启用部分预渲染。

我们建议首先使用 incremental。一旦应用程序中的所有路由都启用了 PPR，就可以认为你可以将 ppr 值设置为 true，并为整个应用程序和所有未来路由启用它。

值得注意的是：

  • 当使用 incremental 时，没有 experimental_ppr 的路由默认值为 false，并且不会使用部分预渲染进行预渲染。你需要为每个路由明确选择加入部分预渲染。
  • 部分预渲染尚未适用于客户端导航。我们正在积极开发这一功能。
  • 部分预渲染设计用于 Node.js 运行时。当你可以立即提供静态外壳时，不需要使用 Edge 运行时。

在 Next.js Learn 课程中了解更多关于部分预渲染的信息。