NNext.js 中文网 GitHub

自动静态优化

只要有可能,Next.js 就会自动将你的应用优化为静态 HTML。在此了解其工作原理。

如果一个页面没有阻塞性的数据需求,Next.js 会自动判定该页面是静态的(可以预渲染)。这一判定依据是页面中不存在 getServerSideProps 和 getInitialProps。

此功能使 Next.js 能够生成混合应用,其中同时包含服务端渲染的页面和静态生成的页面。

小知识:静态生成的页面仍然具有响应能力。Next.js 会在客户端对你的应用进行 hydration,使其具备完整的交互性。

此功能的主要优点之一是,经过优化的页面无需服务端计算,可以从多个 CDN 位置即时流式传输给最终用户。其结果是为用户带来极快的加载体验。

工作原理#

如果页面中存在 getServerSideProps 或 getInitialProps,Next.js 将切换为按需、按请求渲染页面(即服务端渲染)。

如果不属于上述情况,Next.js 将通过把页面预渲染为静态 HTML 来自动静态优化你的页面。

在预渲染期间,路由器的 query 对象将为空,因为在此阶段我们没有可提供的 query 信息。在 hydration 之后,Next.js 将触发应用更新,以在 query 对象中提供路由参数。

会在 hydration 之后更新 query 并触发另一次渲染的情况包括:

  • 页面是动态路由。
  • 页面的 URL 中包含 query 值。
  • next.config.js 中配置了 Rewrites,因为这些配置中可能包含需要解析并提供到 query 中的参数。

要判断 query 是否已完全更新并可使用,你可以利用 next/router 上的 isReady 字段。

小知识:使用 getStaticProps 的页面,通过动态路由添加的参数将始终在 query 对象中可用。

next build 将为静态优化的页面生成 .html 文件。例如,页面 pages/about.js 的结果如下:

Terminal
.next/server/pages/about.html

如果你向页面添加 getServerSideProps,则结果将是 JavaScript 文件,如下所示:

Terminal
.next/server/pages/about.js

注意事项#

  • 如果你有一个带有 getInitialProps 的自定义 App,那么在未使用静态生成的页面上,此优化将被关闭。
  • 如果你有一个带有 getInitialProps 的自定义 Document,请务必先检查 ctx.req 是否已定义,再判断页面是否为服务端渲染。对于预渲染的页面,ctx.req 将为 undefined。
  • 在路由器的 isReady 字段为 true 之前,请避免在渲染树中使用 next/router 的 asPath 值。静态优化的页面只在客户端知道 asPath,在服务端则不知道,因此将其作为 prop 使用可能会导致不匹配错误。active-class-name 示例演示了一种将 asPath 用作 prop 的方法。
Next.js 中文网