跳到内容

Next.js 文档

欢迎来到 Next.js 文档!

什么是 Next.js?

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

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

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

如何使用文档

文档分为 3 个部分

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

使用侧边栏导航各个部分,或使用搜索 (Ctrl+KCmd+K) 快速查找页面。

App Router 和 Pages Router

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

  • App Router:较新的路由器,支持 React 新功能,如服务器组件。
  • Pages Router:原始路由器,仍受支持并持续改进中。

在侧边栏顶部,您会看到一个下拉菜单,允许您在App RouterPages 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 DiscussionsDiscordX (Twitter)Reddit 上提问。

下一步

创建您的第一个应用程序并学习 Next.js 的核心功能。