SuperAPI AI 工具集

nextjs-performance

前端与建站

查看项目

更新于 10-16 01:49

技能介绍

用途:该技能聚焦 Next.js 关键性能与安全问题,在编写代码前提供规则与检查清单,帮助避免常见性能陷阱并保证生产构建正确。

主要能力:

  1. 避免异步瀑布:对相互独立的请求使用 Promise.all(),用 <Suspense> 包裹慢数据,按需将 await 延迟到分支中。示例:const [resumes, jobs] = await Promise.all([fetchResumes(), fetchJobs()]);
  2. 减小打包体积:禁止 barrel 导入(如 import X from 'lucide-react'),改用直接导入(如 import X from 'lucide-react/dist/esm/icons/x');对编辑器、图表、PDF 等重型组件使用 next/dynamic;分析类代码用 ssr: false 延迟加载。示例:const HeavyEditor = dynamic(() => import('./HeavyEditor'), { ssr: false });
  3. 加固 Server Actions:始终在 action 内部检查鉴权,而非仅依赖中间件;变更前验证资源归属。
  4. 生产构建:运行 npm run build && npm run start,而非 npm run dev;Docker 需使用 standalone 输出。

使用方式:编写代码前先阅读 docs/agent/architecture/nextjs-critical-fixes.md 获取完整模式,并检查 apps/frontend/components/ 中已有组件。提交 PR 前按清单自查:独立数据无顺序 await、图标直接导入、重型组件使用 next/dynamic、Server Actions 内部有鉴权、慢请求包裹 Suspense。

适用场景:Next.js 前端项目的性能优化、代码审查与生产部署准备。

限制:资料未提供具体版本要求、兼容性说明或效果数据,实际使用需结合项目情况判断。