Menu

Next.js 文档

欢迎来到 Next.js 文档!

什么是 Next.js?

Next.js 是一个用于构建全栈 Web 应用程序的 React 框架。你可以使用 React Components 构建用户界面,并使用 Next.js 提供的额外功能和优化。

它还会自动配置底层工具,如打包器和编译器。你可以专注于构建产品并快速交付。

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

如何使用文档

文档分为 3 个部分:

  • 入门指南: 分步教程,帮助你创建新应用程序并学习 Next.js 的核心特性。
  • 指南: 针对特定用例的教程,选择与你相关的内容。
  • API 参考: 每个功能的详细技术参考。

使用侧边栏浏览各个部分,或使用搜索功能(Ctrl+KCmd+K)快速找到页面。

App Router 和 Pages Router

Next.js 有两个不同的路由器:

  • App Router: 较新的路由器,支持新的 React 功能,如 Server Components。
  • Pages Router: 原始路由器,仍在支持并持续改进中。

在侧边栏顶部,你会看到一个下拉菜单,允许你在 App RouterPages Router 文档之间切换。

React 版本处理

App Router 和 Pages Router 处理 React 版本的方式不同:

  • App Router: 使用内置的 React canary releases,其中包含所有稳定的 React 19 更改,以及在新 React 版本发布之前在框架中验证的更新功能。

  • Pages Router: 使用项目 package.json 中安装的 React 版本。

这种方法确保新的 React 功能在 App Router 中可靠运行,同时保持现有 Pages Router 应用程序的向后兼容性。

前置知识

我们的文档假设你对 Web 开发有一定的了解。在开始之前,如果你熟悉以下内容会有所帮助:

  • HTML
  • CSS
  • JavaScript
  • React

如果你是 React 新手或需要复习,我们建议从 React 基础课程Next.js 基础课程开始,后者会让你在学习的同时构建应用程序。

无障碍访问

为了在使用屏幕阅读器时获得最佳体验,我们建议使用 Firefox 和 NVDA,或 Safari 和 VoiceOver。

加入我们的社区

如果你对 Next.js 的任何相关问题有疑问,随时欢迎在 GitHub DiscussionsDiscordX (Twitter)Reddit 上向我们的社区提问。

加入「Next.js 中文文档」交流群

如果你有任何关于 Next.js 中文文档的问题,随时欢迎向我们的推特 @weijunext 、即刻@BigYe程普Discord进行交流。

下一步

创建你的第一个应用程序并学习 Next.js 的核心特性。