website

Next.js Docs

所属分类:开发者在线工具箱

Next.js React 框架的官方文档,含 App Router 入门与安装说明。

Next.js 官方文档说明 React 全栈框架的用法,分为入门教程、使用指南与 API 参考三部分。侧边栏可在 App Router 与 Pages Router 之间切换,并按版本查看说明,适合开始用 React 构建网站或全栈应用的开发者。

Next.js Docs:查阅 App Router 的安装、布局、数据获取与缓存说明

发布于 2026年10月18日更新于 2026年10月29日

文档结构与版本切换

文档首页说明,Next.js 是用于构建全栈网络应用的 React 框架:开发者用 React 组件构建界面,Next.js 提供额外功能与优化,并自动配置打包与编译工具。文档分为 Getting Started(入门,分步教程)、Guides(按用例的指南)与 API Reference(功能的详细参考)三部分。左上方的下拉菜单可在 Using App Router 与 Pages Router 之间切换,版本选择器显示为 Latest v16.4.3。

Next.js 文档首页,左侧为版本和入门目录,中间为“Next.js Docs”标题与“What is Next.js?”介绍

截图中的最新版本是 v16.4.2,截至 2026 年 10 月官网为 v16.4.3。

App Router 与 Pages Router

文档页说明两种路由的区别。App Router 是较新的路由方式,支持 Server Components 等 React 新功能;Pages Router 是最初的路由方式,仍受支持并持续改进。两者处理 React 版本的方式也不同:App Router 内置 React canary 版本,Pages Router 则使用项目 package.json 中安装的 React 版本。

安装与系统要求

安装页用 create-next-app 创建项目,可选 pnpm、npm、yarn 或 bun,示例命令为 pnpm create next-app@latest my-app --yes。默认配置启用 TypeScript、Tailwind CSS、ESLint、App Router 与 Turbopack,并生成 AGENTS.md 文件供编程代理参考。运行环境要求 Node.js 最低 20.9,支持 macOS、Windows(含 WSL)与 Linux。支持的浏览器包括 Chrome 111+、Edge 111+、Firefox 111+ 与 Safari 16.4+。

入门页与侧边栏

Getting Started 页面的前提知识列出 HTML、CSS、JavaScript 与 React,并推荐先学习 React Foundations 课程,再学习 Next.js Foundations 课程。侧边栏依次为 Installation、Project Structure、Layouts and Pages、Linking and Navigating、Server and Client Components、Fetching Data、Mutating Data、Caching、Revalidating、Error Handling,之后是 CSS、Image Optimization、Route Handlers、Proxy、Deploying 与 Upgrading 等章节。

Next.js 入门页面,左侧为 App Router 文档目录,正文标题为 Getting Started,下方列出前提知识 HTML、CSS、JavaScript 与 React

截图中的版本同为 v16.4.2,截至 2026 年 10 月官网为 v16.4.3。

搜索与页面工具

页面顶部提供搜索框,快捷键为 Ctrl+K 或 Cmd+K,旁边有 Ask AI 按钮与 GitHub 链接。每个页面右上角有 Copy page 按钮,右侧目录下方的 Edit this page on GitHub 链接可直接进入该页的源文件编辑。