SuperAPI AI 工具集

nextjs-tooling

前端与建站

查看项目

更新于 10-15 22:13

技能介绍

本技能用于配置 Next.js 的构建工具、部署方式与开发者工作流,优先级标记为 P2(中等)。

用途方面,它帮助在 Next.js 项目中统一构建、检查、打包分析、环境变量校验与 CI/CD 缓存策略,并给出应避免的实践。

主要能力与建议:构建上使用 Turbopack(next dev --turbo)获得更快的增量构建,遗留场景使用 Webpack;代码检查上要求在 CI/CD 中强制执行 next lint(eslint-plugin-next)与 tsc;打包体积上使用 @next/bundle-analyzer 检查并移除未使用依赖;遥测上如有隐私要求可用 next telemetry disable 关闭;环境变量上区分仅服务端变量与 NEXT_PUBLIC_*,并用 Zod 在运行时校验;CI/CD 上缓存 .next/cache 以获得 50% 以上的构建加速。资料还提到独立 Docker 配置与环境变量校验有实现示例可参考。

应避免的做法:开发时不要用 npm run start,而应使用 next dev(或 next dev --turbo);不要在未检查打包体积增长的情况下发布,发布前用 @next/bundle-analyzer 分析;不要用自定义 ESLint 规则替代插件,Next.js 感知的检查应使用 eslint-plugin-next;生产环境不要使用 console.log,应改用结构化日志库(如 Pino、Winston)。

适用场景为 Next.js 项目的工程化搭建、构建提速与部署流程规范化。资料还提供 CI/CD 与部署指南作为参考。具体实现代码、完整配置示例及官方文档链接暂未提供。