# 自动静态优化
Next.js自动确定一个页面是静态的(可以预渲染),如果它没有阻塞数据需求。这个决定是由于页面中没有getServerSideProps
和getInitialProps
。
This feature allows Next.js to emit hybrid applications that contain both server-rendered and statically generated pages.
Statically generated pages are still reactive: Next.js will hydrate your application client-side to give it full interactivity.
One of the main benefits of this feature is that optimized pages require no server-side computation, and can be instantly streamed to the end-user from multiple CDN locations. The result is an ultra fastloading experience for your users.
# How it works
If getServerSideProps
or getInitialProps
is present in a page, Next.js will switch to render the page on-demand, per-request (meaning Server-Side Rendering
).
If the above is not the case, Next.js will statically optimizeyour page automatically by prerendering the page to static HTML.
During prerendering, the router's query
object will be empty since we do not have query
information to provide during this phase. After hydration, Next.js will trigger an update to your application to provide the route parameters in the query
object.
**Note:**Parameters added with
dynamic routes
to a page that's usinggetStaticProps
will always be available inside thequery
object.
next build
will emit .html
files for statically optimized pages. For example, the result for the page pages/about.js
would be:
.next/server/pages/about.html
And if you add getServerSideProps
to the page, it will then be JavaScript, like so:
.next/server/pages/about.js
# Caveats
- If you have a
custom App
withgetInitialProps
then this optimization will be turned off in pages withoutStatic Generation
. - If you have a
custom Document
withgetInitialProps
be sure you check ifctx.req
is defined before assuming the page is server-side rendered.ctx.req
will beundefined
for pages that are prerendered.