Next.js 文档 (v16.2.0-canary.30)

完整的 Next.js 16 文档已嵌入 Markdown 格式。请从references/目录中读取内容，以回答有关 Next.js 功能、配置和最佳实践的问题。

文档结构

所有文档均位于references/目录下，并按主题组织：

核心文档

应用路由器 (references/01-app/)

采用 React 服务器组件的现代 Next.js 架构。

入门指南：

• references/01-app/01-getting-started/installation.mdx- 设置新项目
• references/01-app/01-getting-started/project-structure.mdx- 文件约定
• references/01-app/01-getting-started/layouts-and-pages.mdx- 路由基础
• references/01-app/01-getting-started/data-fetching.mdx- 服务器端数据加载
• references/01-app/01-getting-started/css.mdx- 样式选项

指南：

• references/01-app/02-guides/authentication.mdx- 身份验证模式
• references/01-app/02-guides/caching.mdx- 缓存策略
• references/01-app/02-guides/environment-variables.mdx- 环境变量配置
• references/01-app/02-guides/forms.mdx- 表单处理
• references/01-app/02-guides/testing/- Jest, Playwright, Vitest, Cypress
• references/01-app/02-guides/migrating/- 迁移指南 (Vite, CRA, Pages → App)
• references/01-app/02-guides/upgrading/- 版本升级指南 (14, 15, 16)
• references/01-app/02-guides/self-hosting.mdx- 自托管部署
• references/01-app/02-guides/static-exports.mdx- 静态 HTML 导出
• references/01-app/02-guides/progressive-web-apps.mdx- PWA 设置

API 参考：

• references/01-app/03-api-reference/- 完整的 API 文档（组件、函数、配置）

页面路由器 (references/02-pages/)

遗留的 Next.js 架构（仍受支持）。

• references/02-pages/01-guides/- 页面路由器指南
• references/02-pages/02-api-reference/- 页面 API 参考

架构 (references/03-architecture/)

• references/03-architecture/nextjs-compiler.mdx- SWC 编译器
• references/03-architecture/fast-refresh.mdx- 热重载
• references/03-architecture/supported-browsers.mdx- 浏览器支持
• references/03-architecture/accessibility.mdx- 无障碍功能

社区 (references/04-community/)

• references/04-community/contribution-guide.mdx- 为 Next.js 做贡献
• references/04-community/rspack.mdx- 实验性 Rspack 支持

快速参考

常见任务

何时使用此技能

• 用户询问关于 Next.js 功能、配置或最佳实践
• 正在处理 Next.js 项目并需要 API 参考
• 调试 Next.js 行为（缓存、渲染、路由）
• 规划架构（SSR vs SSG vs ISR）
• 迁移问题（从其他框架或旧版 Next.js 迁移）

如何导航

1. 从references/index.mdx开始以获取概览
2. 对于入门指南：阅读references/01-app/01-getting-started/
3. 对于特定主题：阅读references/01-app/02-guides/<topic>.mdx
4. 对于API详情：搜索references/01-app/03-api-reference/
5. 对于旧版Pages Router：使用references/02-pages/

所有文件均为.mdx（Markdown + JSX）格式，但可作为纯Markdown阅读。