Next.js Best Practices 是一套在编写或审查 Next.js 代码时应用的规则集合，按主题组织为多份参考文档。
用途 用于在开发或代码审查过程中对照 Next.js 的推荐做法，覆盖从项目结构到性能优化的多个方面。
主要能力（按主题）
- 文件约定：项目结构与特殊文件、路由段（动态、catch-all、分组）、并行与拦截路由、v16 中 middleware 重命名为 proxy。
- RSC 边界：检测无效的 React Server Component 模式，包括异步客户端组件检测（无效）、不可序列化 props 检测、Server Action 异常。
- 异步模式：Next.js 15+ 的异步 API 变更，包括异步 params 与 searchParams、异步 cookies() 与 headers()、迁移 codemod。
- 运行时选择：默认使用 Node.js 运行时，以及何时适合使用 Edge 运行时。
- 指令：'use client'、'use server'（React）与 'use cache'（Next.js）。
- 函数：导航钩子（useRouter、usePathname、useSearchParams、useParams）、服务端函数（cookies、headers、draftMode、after）、生成函数（generateStaticParams、generateMetadata）。
- 错误处理：error.tsx、global-error.tsx、not-found.tsx；redirect、permanentRedirect、notFound；forbidden、unauthorized（认证错误）；catch 块中的 unstable_rethrow。
- 数据模式：Server Components 与 Server Actions 与 Route Handlers 的对比；避免数据瀑布（Promise.all、Suspense、preload）；客户端组件数据获取。
- 路由处理器：route.ts 基础；GET 处理器与 page.tsx 的冲突；环境行为（无 React DOM）；何时使用它而非 Server Actions。
- 元数据与 OG 图片：静态与动态元数据、generateMetadata 函数、使用 next/og 生成 OG 图片、基于文件的元数据约定。
- 图片优化：始终使用 next/image 而非 <img>、远程图片配置、响应式 sizes 属性、模糊占位符、LCP 的优先加载。
- 字体优化：next/font 设置、Google Fonts 与本地字体、Tailwind CSS 集成、预加载子集。
- 打包：服务端不兼容的包、CSS 导入（而非 link 标签）、polyfills（已内置）、ESM/CommonJS 问题、包分析。
- 脚本：next/script 与原生 script 标签、内联脚本需要 id、加载策略、使用 @next/third-parties 接入 Google Analytics。
- 水合错误：常见原因（浏览器 API、日期、无效 HTML）、使用错误覆盖层调试、针对每种原因的修复。
- Suspense 边界：useSearchParams 与 usePathname 导致的 CSR bailout、哪些钩子需要 Suspense 边界。
- 并行与拦截路由：使用 @slot 与 (.) 拦截器的模态框模式、用于回退的 default.tsx、使用 router.back() 正确关闭模态框。
- 自托管：用于 Docker 的 output: 'standalone'、多实例 ISR 的缓存处理器、哪些可用与哪些需要额外配置。
- 调试技巧：用于 AI 辅助调试的 MCP 端点、使用 --debug-build-paths 重建特定路由。
使用方式 在编写或审查 Next.js 代码时应用这些规则，并按需查阅对应的参考文档（如 file-conventions.md、rsc-boundaries.md、async-patterns.md 等）。
适用场景 适用于 Next.js 项目的开发与代码审查，尤其是涉及 RSC、异步 API、路由、数据获取、性能优化与自托管等主题时。
限制 资料未提供具体的安装命令、版本兼容范围、收费方式或平台限制等信息。