NNext.js 中文网 GitHub

Next.js 术语表

Next.js 中常用术语的术语表。

本术语表定义了 Next.js 文档中常用的术语,包括与路由、渲染和缓存相关的术语。

A#

App Router#

Next.js 在版本 13 中引入的路由器,构建于 React Server Components 之上。它使用基于文件系统的路由,并支持 layout、嵌套路由、加载状态、错误处理等。在 App Router 文档中了解更多。

App Shell#

按路由进行的预渲染,包含页面中不依赖 URL 数据的部分。当其 stale 时间至少为 5 分钟时,缓存内容会被包含在内,因为 shell 的复用时间比短期内容的保鲜时间更长。读取 cookies() 或 headers() 的路由会生成一个还包含会话数据的 App Shell,并在客户端按会话缓存。它用作客户端导航期间的默认预取载荷、按链接预取尚未就绪时的加载状态,以及使用 Cache Components 的 ISR 的回退方案。

B#

构建时#

应用被编译的阶段。在构建时,Next.js 会将你的代码转换为针对生产环境优化的文件、生成静态页面,并为部署准备资源。请参阅 next build CLI 参考。

C#

Cache Components#

一项使用 "use cache" 指令实现组件级和函数级缓存的特性。Cache Components 允许你在单个路由中混合静态、缓存和动态内容:预先渲染静态 HTML shell 并立即提供服务,而动态内容在就绪后流式传入。使用 cacheLife()配置缓存时长,使用 cacheTag()为缓存数据添加标签,并使用 updateTag()按需使其失效。在 Cache Components 指南中了解更多。

捕获所有 Segment#

使用 [...folder]/page.js 语法、可匹配多个 URL 部分的动态路由 segment。这些 segment 会捕获所有剩余的 URL segment,适用于实现文档站点或文件浏览器等功能。在动态路由 Segment中了解更多。

客户端打包产物#

发送到浏览器的 JavaScript 打包产物。Next.js 会基于模块图自动拆分这些产物,以减小初始载荷大小,并仅加载每个页面所需的代码。

Client Component#

在浏览器中运行的 React 组件。在 Next.js 中,Client Component 也可以在初始页面生成期间在服务端渲染。它们可以使用 state、effect、事件处理器和浏览器 API,并在文件顶部用 "use client" 指令标记。在Server 和 Client Component中了解更多。

客户端导航#

一种无需整页重新加载即可动态更新页面内容的导航技术。Next.js 通过 <Link> 组件使用客户端导航,使共享 layout 保持交互并保留浏览器状态。在链接与导航中了解更多。

客户端缓存#

浏览器中的内存缓存,用于存储已访问和已预取路由的 RSC Payload。在客户端导航期间,Next.js 无需服务端请求即可立即提供缓存的 layout 和加载状态。页面默认不缓存,但会在浏览器前进/后退导航时被复用。

客户端缓存会在页面刷新时清除。可以通过 revalidateTag、revalidatePath、updateTag、router.refresh、cookies.set 或 cookies.delete 以编程方式使其失效。

你可以使用 staleTimes 全局配置客户端缓存时长,或通过 cacheLife 中的 stale 属性按路由配置(推荐)。

代码分割#

根据路由将应用拆分为更小的 JavaScript 代码块的过程。Next.js 不会预先加载所有代码,而是只加载当前路由所需的代码,从而缩短初始加载时间。Next.js 会自动基于路由执行代码分割。在包打包指南中了解更多。

D#

动态渲染#

组件在请求时(而非构建时)渲染。当组件使用请求时 API时,它就变成了动态组件。

动态路由 Segment#

在请求时根据数据生成的路由 segment。通过将文件夹名包裹在方括号中(例如 [slug])来创建,使你能够基于博客文章或产品页面等动态数据创建路由。在动态路由 Segment中了解更多。

E#

环境变量#

可在构建时或请求时访问的配置值。在 Next.js 中,以 NEXT_PUBLIC_ 为前缀的变量会暴露给浏览器,而其他变量仅在服务端可用。在环境变量中了解更多。

错误边界#

一种 React 组件,用于捕获其子组件树中的 JavaScript 错误并显示回退 UI。在 Next.js 中,创建 error.js 文件即可自动将路由 segment 包裹在错误边界中。在错误处理中了解更多。

F#

字体优化#

使用 next/font 自动优化字体。Next.js 会自托管字体、消除布局偏移,并应用性能最佳实践。支持 Google Fonts 和本地字体文件。在字体中了解更多。

文件系统缓存#

Turbopack 的一项特性,可在两次运行之间将编译产物存储在磁盘上,减少 next dev 或 next build 命令的重复工作,从而显著加快编译速度。在 Turbopack 文件系统缓存中了解更多。

H#

水合(Hydration)#

React 将事件处理器附加到 DOM,使服务端渲染的静态 HTML 具备交互性的过程。在水合期间,React 会将服务端渲染的标记与客户端 JavaScript 进行调和。在Server 和 Client Component中了解更多。

I#

导入别名#

为常用目录提供简写引用的自定义路径映射。导入别名降低了相对导入的复杂性,使代码更易读、更易维护。在绝对导入和模块路径别名中了解更多。

Incremental Static Regeneration (ISR)#

一种无需重新构建整个站点即可更新静态内容的技术。ISR 使你能够按页面使用静态生成,同时在流量进入时在后台重新验证页面。在 ISR 指南中了解更多;如果使用 Cache Components,请参阅使用 Cache Components 的 ISR。

小知识:在 Next.js 中,ISR 也被称为重新验证。

拦截路由#

一种路由模式,允许在当前 layout 中加载应用其他部分的路由。适用于在用户不切换上下文的情况下显示内容(如模态框),同时保持 URL 可分享。在拦截路由中了解更多。

图片优化#

使用 <Image> 组件自动优化图片。Next.js 会按需优化图片,以 WebP 等现代格式提供,并自动处理懒加载和响应式尺寸。在图片中了解更多。

L#

Layout#

在多个页面之间共享的 UI。Layout 会保留状态、保持交互,并且在导航时不会重新渲染。通过从 layout.js 文件导出 React 组件来定义。在Layout 和页面中了解更多。

加载 UI#

在路由 segment 加载时显示的回退 UI。通过向文件夹添加 loading.js 文件来创建,它会自动将页面包裹在 Suspense 边界中。在加载 UI中了解更多。

M#

模块图#

应用中文件依赖关系的图。每个文件(模块)是一个节点,导入/导出关系构成边。Next.js 会分析该图以确定最佳的打包和代码分割策略。在Server 和 Client Component中了解更多。

元数据#

浏览器和搜索引擎使用的页面信息,例如标题、描述和 Open Graph 图片。在 Next.js 中,可以在 layout 或页面文件中使用 metadata 导出或 generateMetadata 函数来定义元数据。在元数据和 OG 图片中了解更多。

记忆化(Memoization)#

缓存函数的返回值,使同一次渲染过程(请求)中多次调用同一函数时只执行一次。在 Next.js 中,具有相同 URL 和选项的 fetch GET 请求会在 Server Component、layout、页面以及 generateMetadata/generateStaticParams 之间自动记忆化(但 Route Handler 除外,因为它们不属于 React 组件树)。

对于非 fetch 操作,请使用 React 的 cache 函数。在 fetch API 参考中了解更多。

Middleware#

请参阅 Proxy。

N#

导航阶段#

在客户端导航期间,服务端渲染成果变为可用的时间节点。使用部分预取时,这些阶段包括 App Shell、按链接预取以及导航。在 ensureStatic、prefetch() 和 navigation() API 参考中了解更多。

未找到#

当路由不存在或调用 notFound() 函数时显示的特殊组件。通过向 app 目录添加 not-found.js 文件来创建。在错误处理中了解更多。

P#

私有文件夹#

以下划线为前缀(例如 _components)的文件夹,会被排除在路由系统之外。这些文件夹用于代码组织和共享工具,而不会创建可访问的路由。在私有文件夹中了解更多。

页面#

某个路由独有的 UI。通过从 app 目录中的 page.js 文件导出 React 组件来定义。在Layout 和页面中了解更多。

平行路由#

一种允许在同一 layout 中同时或按条件渲染多个页面的模式。使用 @folder 约定创建命名插槽,适用于仪表盘、模态框和复杂布局。在平行路由中了解更多。

部分预取#

针对 Cache Components 路由的预取策略,其中 <Link> 默认预取按路由的 App Shell,而非整个页面。在 next.config.ts 中使用 partialPrefetching: true 启用它。在采用部分预取指南中了解更多。

Partial Prerendering (PPR)#

一种在单个路由中结合预渲染和动态渲染的渲染优化。静态 shell 会立即提供,而动态内容在就绪后流式传入,兼具两种渲染策略的优点。在 Cache Components中了解更多。

预取#

在用户导航到某个路由之前,在后台加载该路由。当使用 <Link> 组件链接的路由进入视口时,Next.js 会自动预取它们,使导航感觉即时。在预取指南中了解更多。

预渲染#

组件在构建时或在重新验证期间于后台渲染。结果为 HTML 和 RSC Payload,可以缓存并从 CDN 提供。对于不使用请求时 API的组件,预渲染是默认行为。

Proxy#

一个在请求完成之前在服务端运行代码的文件(proxy.js)。用于实现日志记录、重定向和重写等服务端逻辑。旧称 Middleware。在 Proxy 指南中了解更多。

R#

重定向#

将用户从一个 URL 发送到另一个 URL。在 Next.js 中,重定向可以在 next.config.js中配置、由 Proxy 返回,或使用 redirect() 函数以编程方式触发。在重定向中了解更多。

请求时 API#

访问请求特定数据的函数,会使组件选择加入动态渲染。这些函数包括:

运行时渲染#

请参阅动态渲染。

重新验证#

更新缓存数据的过程。可以基于时间(使用 cacheLife()设置缓存时长),也可以按需(使用 cacheTag()为数据添加标签,然后使用 updateTag()使其失效)。在缓存与重新验证中了解更多。

重写#

将传入的请求路径映射到不同的目标路径,而不改变浏览器中的 URL。在 next.config.js中配置,或由 Proxy 返回。适用于代理到外部服务或旧版 URL。

路由组#

一种在不影响 URL 结构的情况下组织路由的方式。通过将文件夹名包裹在括号中(例如 (marketing))来创建,路由组有助于组织相关路由并启用按组的 layout。在路由组中了解更多。

Route Handler#

处理特定路由 HTTP 请求的函数,定义在 route.js 文件中。Route Handler 使用 Web Request 和 Response API,可以处理 GET、POST、PUT、PATCH、DELETE、HEAD 和 OPTIONS 方法。在 Route Handler中了解更多。

路由 Segment#

由 app 目录中的文件夹定义的 URL 路径的一部分(两个斜杠之间)。每个文件夹代表 URL 结构中的一个 segment。在项目结构中了解更多。

RSC Payload#

React Server Component Payload 是渲染后的 React Server Components 树的紧凑二进制表示。它包含 Server Component 的渲染结果、Client Component 的占位符以及在它们之间传递的 props。在Server 和 Client Component中了解更多。

S#

Server Component#

App Router 中的默认组件类型。Server Component 在服务端渲染,可以直接获取数据,且不会增加客户端 JavaScript bundle。它们不能使用 state 或浏览器 API。在Server 和 Client Component中了解更多。

Server Action#

作为 prop 传递给 Client Component 或绑定到表单 action 的 Server Function。Server Action 通常用于表单提交和数据变更。在Server Actions 与数据变更中了解更多。

Server Function#

在服务端运行的异步函数,使用 "use server" 指令标记。Server Function 可以从 Client Component 调用。当作为 prop 传递给 Client Component 或绑定到表单 action 时,它们被称为 Server Action。在 React Server Functions中了解更多。

静态导出#

一种生成包含 HTML、CSS 和 JavaScript 文件的全静态站点的部署模式。通过在 next.config.js 中设置 output: 'export' 来启用。静态导出可以托管在任何静态文件服务器上,无需 Node.js 服务器。在静态导出中了解更多。

静态渲染#

请参阅预渲染。

静态资源#

图片、字体、视频等无需处理即可直接提供的媒体文件。静态资源通常存储在 public 目录中,并通过其相对路径引用。在静态资源中了解更多。

静态 Shell#

页面的预渲染 HTML 结构,会立即提供给浏览器。使用部分预渲染时,静态 shell 包含所有可静态渲染的内容,以及针对稍后流式传入的动态内容的 Suspense 边界回退。

流式渲染#

一种允许服务端在页面的各部分准备就绪时将其发送到客户端,而不必等待整个页面渲染完成的技术。使用 loading.js或手动添加 <Suspense> 边界即可自动启用。在流式渲染指南中了解更多。

Suspense 边界#

一个 React <Suspense> 组件,用于包裹异步内容并在加载时显示回退 UI。在 Next.js 中,Suspense 边界定义了静态 shell 的结束位置和流式渲染的开始位置,从而实现部分预渲染。

T#

Turbopack#

专为 Next.js 打造的快速、基于 Rust 的打包工具。Turbopack 是 next dev 的默认打包工具,也可用于 next build。与 Webpack 相比,它提供了显著更快的编译速度。在 Turbopack中了解更多。

Tree Shaking#

在构建过程中从 JavaScript bundle 中移除未使用代码的过程。Next.js 会自动对代码进行 tree-shaking 以减小打包体积。在包打包指南中了解更多。

U#

URL 数据#

用于标识特定 URL 的数据,例如路径名和查询参数。在 App Router 中,这指的是 params 和 searchParams,以及读取它们的客户端 hook(如 usePathname 和 useSearchParams)。URL 数据因链接而异,而非因会话而异,因此它不能成为共享 App Shell 的一部分。

"use cache" 指令#

将组件或函数标记为可缓存的指令。它可以放在文件顶部,表示文件中的所有导出都是可缓存的;也可以内联放在函数或组件顶部,将该特定作用域标记为可缓存。在 "use cache" 参考中了解更多。

"use client" 指令#

一个特殊的 React 指令,用于标记服务端代码与客户端代码之间的边界。它必须放在文件顶部,位于任何导入或其他代码之前。它表示 React Component、辅助函数、变量声明以及所有导入的依赖项都应被包含在客户端打包产物中。在 "use client" 参考中了解更多。

"use server" 指令#

将函数标记为可从客户端代码调用的 Server Function 的指令。它可以放在文件顶部,表示文件中的所有导出都是 Server Function;也可以内联放在函数顶部,标记该特定函数。在 "use server" 参考中了解更多。

V#

版本不匹配(Version skew)#

在部署应用的新版本后,仍处于活跃状态的客户端可能会引用来自较旧构建的 JavaScript、CSS 或数据。这种客户端与服务端版本之间的不匹配称为版本不匹配(version skew),它可能导致资源缺失、Server Action 错误和导航失败。Next.js 使用 deploymentId 来检测和处理版本不匹配。在自托管 - 版本不匹配中了解更多。

Next.js 中文网