Introduction

Welcome to the Next.js documentation!

What is Next.js?

Next.js 是一个用于构建全栈 Web 应用程序的 React 框架。您使用 React 组件来构建用户界面，并使用 Next.js 来提供额外的功能和优化。

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

无论您是个人开发者还是较大团队的一部分，Next.js 都可以帮助您构建交互式、动态和快速的 React 应用程序。

Main Features

Next.js 的一些主要功能包括：

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

How to Use These Docs

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

在屏幕的右侧，您将看到一个目录，它使您更容易在页面的各个部分之间导航。如果您需要快速找到页面，可以使用顶部的搜索栏，或使用搜索快捷键（Ctrl+K 或 Cmd+K）。

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

App Router vs Pages Router

Next.js 提供了两种不同的路由：App Router 和 Pages Router。App Router 是一个较新的路由，它允许您使用 React 的最新特性，例如 Server Components 和 Streaming。Pages Router 是 Next.js 的原始路由，它允许您构建服务器渲染的 React 应用程序，并继续为旧版本的 Next.js 应用程序提供支持。

在侧边栏的顶部，您会注意到一个下拉菜单，允许您在 App Router 和 Pages Router 功能之间切换。由于每个目录都有其独特的功能，因此跟踪当前选中的标签非常重要。

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

预备知识

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

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

可访问性

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

加入我们的社区

如果您对 Next.js 相关的任何问题有疑问，您可以随时在我们的 GitHub Discussions、Discord、Twitter 和 Reddit 上向我们的社区提问。