用途:在编写或审查 Next.js 代码时应用一套 App Router 最佳实践规则,按主题分文件组织,便于逐项查阅。
主要能力:文件约定(项目结构、特殊文件、动态/全捕获/分组路由段、并行与拦截路由,以及 v16 中 middleware.ts 更名为 proxy.ts 的说明);RSC 边界(检测异步客户端组件、不可序列化 props、Server Action 异常等无效模式);异步模式(Next.js 16.1.6+ 的异步 params 与 searchParams、异步 cookies() 与 headers()、迁移 codemod);运行时选择(默认 Node.js,何时用 Edge);指令('use client'、'use server'、'use cache');函数(导航钩子、服务端函数、generateStaticParams、generateMetadata);错误处理(error.tsx、global-error.tsx、not-found.tsx、redirect、notFound、forbidden、unauthorized、unstable_rethrow);数据模式(Server Components 与 Server Actions、Route Handlers 的取舍,避免数据瀑布);路由处理器;元数据与 OG 图片;图片优化(next/image、远程图片、sizes、模糊占位、LCP 优先级);字体优化(next/font、Google 与本地字体、Tailwind 集成);打包(服务端不兼容包、CSS 导入、polyfill、ESM/CommonJS、包分析);脚本(next/script、内联脚本 id、加载策略、@next/third-parties);水合错误;Suspense 边界;并行与拦截路由(模态框模式、default.tsx、router.back());自托管(output: 'standalone'、多实例 ISR 缓存处理器);调试技巧(MCP 端点、--debug-build-paths)。
使用方式:按主题查阅对应说明文件并套用规则;注意 Next.js 16 将 middleware.ts 更名为 proxy.ts,需确认所用版本是否支持 proxy.ts,middleware.ts 仍为稳定 API。
限制:资料未提供安装命令、具体代码示例、收费与平台信息,暂未提供。