NNext.js 中文网 GitHub

Next.js 文档

欢迎阅读 Next.js 文档。

欢迎阅读 Next.js 文档!

什么是 Next.js?#

Next.js 是一个用于构建全栈 Web 应用的 React 框架。你使用 React 组件构建用户界面,而 Next.js 提供额外的功能和优化。

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

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

如何使用文档#

文档分为 3 个部分:

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

使用侧边栏浏览各部分,或通过搜索(Ctrl+K 或 Cmd+K)快速查找页面。

App Router 和 Pages Router#

Next.js 有两种不同的路由:

  • App Router:较新的路由,支持 Server Components 等新的 React 特性。
  • Pages Router:最初的路由,仍然受支持并持续得到改进。

在侧边栏顶部,你会看到一个下拉菜单,可用于在 App Router 和 Pages Router 文档之间切换。

React 版本处理#

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

  • App Router:内置使用 React canary 版本,其中包含所有稳定的 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 Discussions、Discord、X (Twitter) 和 Reddit 上向社区提问。

Next.js 中文网