SuperAPI AI 工具集

next-best-practices

通用与其它

查看项目

更新于 10-16 07:20

技能介绍

用途:在编写或审查 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、unstable_rethrow);数据模式(Server Components 与 Server Actions、Route Handlers 的取舍,用 Promise.all、Suspense、preload 避免数据瀑布,客户端组件取数);路由处理器(route.ts 基础、GET 与 page.tsx 冲突、环境行为、与 Server Actions 的取舍);元数据与 OG 图片(静态/动态元数据、generateMetadata、next/og、基于文件的元数据约定);图片优化(优先 next/image、远程图片配置、sizes、模糊占位、LCP 优先加载);字体优化(next/font、Google 字体与本地字体、Tailwind 集成、子集预加载);打包(服务端不兼容包、CSS 导入、polyfill、ESM/CommonJS、包分析);脚本(next/script、内联脚本需 id、加载策略、@next/third-parties 接入 Google Analytics);水合错误(常见成因与修复);Suspense 边界(useSearchParams、usePathname 的 CSR bailout);并行与拦截路由(@slot 与 (.) 拦截器实现模态框、default.tsx 回退、router.back() 关闭);自托管(output: 'standalone' 用于 Docker、多实例 ISR 的缓存处理器);调试技巧(AI 辅助调试的 MCP 端点、用 --debug-build-paths 重建特定路由)。

使用方式:资料未提供具体安装或调用命令,仅说明在编写或审查 Next.js 代码时套用这些规则,各主题细节见对应 .md 文件。

适用场景:Next.js 项目的开发、代码审查与迁移(尤其 15+ 异步 API 与 v16 变更)。

限制:资料未说明支持的 Next.js 版本范围、依赖、收费或平台信息,暂未提供。