介绍
# Next.js Documentation (v16.2.0-canary.30)
嵌入在 Markdown 中的完整 Next.js 16 文档。请阅读 `references/` 目录以回答关于 Next.js 功能、配置和最佳实践的问题。
## 文档结构
所有文档均位于 `references/` 目录中，并按主题组织：
### 核心文档
#### App Router (references/01-app/)
采用 React Server Components 的现代 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 文档 (组件、函数、配置)
#### Pages Router (references/02-pages/)
传统的 Next.js 架构 (仍受支持)。
- `references/02-pages/01-guides/` - Pages Router 指南 - `references/02-pages/02-api-reference/` - Pages 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` - 无障碍 (A11y) 功能
#### 社区 (references/04-community/) - `references/04-community/contribution-guide.mdx` - 为 Next.js 做贡献 - `references/04-community/rspack.mdx` - 实验性 Rspack 支持
## 快速参考
### 常见任务
| 任务 | 阅读文件 | |------|--------------| | 设置新项目 | `references/01-app/01-getting-started/installation.mdx` | | 路由与布局 | `references/01-app/01-getting-started/layouts-and-pages.mdx` | | 数据获取 | `references/01-app/01-getting-started/data-fetching.mdx` | | Server Actions | `references/01-app/03-api-reference/server-actions.mdx` (如果存在) | | 中间件 | 搜索 `references/01-app/02-guides/` 或 API 参考 | | 缓存策略 | `references/01-app/02-guides/caching.mdx` | | 环境变量 | `references/01-app/02-guides/environment-variables.mdx` | | 测试设置 | `references/01-app/02-guides/testing/` | | 自托管部署 | `references/01-app/02-guides/self-hosting.mdx` | | 从 Vite 迁移 | `references/01-app/02-guides/migrating/from-vite.mdx` | | 从 CRA 迁移 | `references/01-app/02-guides/migrating/from-create-react-app.mdx` | | 升级到 v16 | `references/01-app/02-guides/upgrading/version-16.mdx` |
### 何时使用此技能
- 用户询问 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 阅读。