用途:在编写或审查 Next.js 代码时应用一套最佳实践规则,覆盖从项目结构到性能优化的多个方面。
主要能力(按主题分文档):文件约定(项目结构与特殊文件、动态/全捕获/分组路由段、并行与拦截路由、v16 中 middleware 更名为 proxy);RSC 边界(检测异步客户端组件、不可序列化 props、Server Action 异常等无效模式);异步模式(Next.js 15+ 的异步 params 与 searchParams、异步 cookies() 与 headers()、迁移 codemod);运行时选择(默认 Node.js,何时用 Edge);指令('use client'、'use server'、'use cache');函数(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 图片(静态/动态 metadata、generateMetadata、next/og 生成 OG 图、基于文件的元数据约定);图片优化(用 next/image 替代 img、远程图片配置、响应式 sizes、模糊占位、LCP 优先加载);字体优化(next/font、Google Fonts 与本地字体、Tailwind 集成、子集预加载);打包(服务端不兼容包、CSS 导入、polyfill、ESM/CommonJS 问题、包分析);脚本(next/script 与原生标签、内联脚本需 id、加载策略、用 @next/third-parties 接入 Google Analytics);水合错误(常见成因与修复、错误浮层调试);Suspense 边界(useSearchParams 与 usePathname 的 CSR bailout、哪些钩子需要边界);并行与拦截路由(@slot 与 (.) 拦截器的模态模式、default.tsx 回退、用 router.back() 正确关闭模态);自托管(Docker 用 output: 'standalone'、多实例 ISR 的缓存处理器、可用与需额外配置的部分);调试技巧(AI 辅助调试的 MCP 端点、用 --debug-build-paths 重建特定路由)。
使用方式:资料未提供具体安装命令或调用步骤,仅说明在编写或审查 Next.js 代码时应用这些规则,并查阅对应主题的参考文档。
适用场景:Next.js 项目的开发、代码审查与迁移(如升级到 15+/16 的异步 API 与 middleware 更名)。
限制:资料未说明支持的 Next.js 版本范围、依赖要求、收费或平台信息;具体命令与配置细节需查阅各主题文档。