简介

欢迎来到 Next.js 文档！

什么是 Next.js?

Next.js 是一个用于构建全栈 Web 应用程序的 React 框架。你使用 React 组件来构建用户界面，并使用 Next.js 来获得额外的特性和优化。

在底层，Next.js 还抽象化并自动配置了 React 所需的工具，例如捆绑、编译等等。这使你可以专注于构建你的应用程序，而不是花费时间进行配置。

无论你是个体开发者还是大型团队的一员，Next.js 都可以帮助你构建交互式、动态且快速的 React 应用程序。

主要特性

Next.js 的一些主要特性包括

特性	描述
路由	一个基于文件系统的路由器，构建于服务器组件之上，支持布局、嵌套路由、加载状态、错误处理等等。
渲染	客户端和服务端渲染，使用客户端和服务器组件。通过 Next.js 在服务器上进行静态和动态渲染进一步优化。在 Edge 和 Node.js 运行时上进行流式处理。
数据获取	简化的数据获取，在服务器组件中使用 async/await，以及扩展的 `fetch` API 用于请求记忆化、数据缓存和重新验证。
样式	支持你偏好的样式化方法，包括 CSS Modules、Tailwind CSS 和 CSS-in-JS
优化	图像、字体和脚本优化，以改善你的应用程序的核心 Web 指标和用户体验。
TypeScript	改进了对 TypeScript 的支持，具有更好的类型检查和更高效的编译，以及自定义 TypeScript 插件和类型检查器。

如何使用这些文档

在屏幕的左侧，你会找到文档导航栏。文档页面按从基础到高级的顺序组织，因此你可以在构建应用程序时逐步跟随它们。但是，你可以按任何顺序阅读它们，或跳到适用于你的用例的页面。

在屏幕的右侧，你会看到一个目录，它可以让你更轻松地在页面的各个部分之间导航。如果你需要快速找到页面，可以使用顶部的搜索栏，或搜索快捷键 (Ctrl+K 或 Cmd+K)。

要开始使用，请查看安装指南。

App Router vs Pages Router

Next.js 有两个不同的路由器：App Router 和 Pages Router。App Router 是一个较新的路由器，允许你使用 React 的最新特性，例如服务器组件和流式处理。Pages Router 是原始的 Next.js 路由器，它允许你构建服务器渲染的 React 应用程序，并继续为较旧的 Next.js 应用程序提供支持。

在侧边栏的顶部，你会注意到一个下拉菜单，允许你在 App Router 和 Pages Router 特性之间切换。由于每个目录都有独特的特性，因此务必跟踪选择了哪个选项卡。

页面顶部的面包屑导航也将指示你正在查看 App Router 文档还是 Pages Router 文档。

预备知识

虽然我们的文档旨在对初学者友好，但我们需要建立一个基线，以便文档可以专注于 Next.js 功能。每当我们引入新概念时，我们都会确保提供相关文档的链接。

为了充分利用我们的文档，建议你对 HTML、CSS 和 React 有基本的了解。如果你需要复习你的 React 技能，请查看我们的React 基础课程，它将向你介绍基础知识。然后，通过构建仪表板应用程序来了解更多关于 Next.js 的信息。

无障碍访问

为了在使用屏幕阅读器阅读文档时获得最佳可访问性，我们建议使用 Firefox 和 NVDA，或 Safari 和 VoiceOver。

加入我们的社区

如果你对与 Next.js 相关的任何事情有疑问，随时欢迎在 GitHub Discussions、Discord、X (Twitter) 和 Reddit 上向我们的社区提问。

简介