Next.js 工具链
优先级:P2(中)
项目结构
project/
├── .next/ # 构建产物
├── next.config.js # 高级配置
└── .eslintrc.json # Next 插件
实施指南
- 构建架构:使用
Turbopack(现代)或 Webpack(传统)。启用 --turbo 以获得更快的增量开发速度。
- 代码压缩:确保在
next.config.js 中设置了 output: 'standalone',以实现优化的 Docker 部署。对于资源压缩,使用等效的 ProGuard / Uglify 工具。
- 代码检查:强制在 CI/CD 管道中运行
next lint(Next.js ESLint 插件)和 tsc(类型检查)。
- 资源优化:使用
@next/bundle-analyzer 检查体积。通过 next/image 优化图片,并移除未使用的依赖。
- 遥测:如果隐私要求,可通过
next telemetry disable 选择退出。
- 环境变量:在 Next.js 中使用
.env 管理环境变量(仅服务端 sensitive vs NEXT_PUBLIC_*)。运行时使用 Zod 验证模式。
- CI/CD:在 CI 中缓存
.next/cache 文件夹,可将构建速度提升 50% 以上。
反模式
- 不要用
npm run start 进行开发:应使用 next dev(或 next dev --turbo)。
- 不要忽视包体积增长:发布前使用
@next/bundle-analyzer 进行分析。
- 不要使用自定义 ESLint 规则替代插件:应使用
eslint-plugin-next 进行 Next.js 感知的代码检查。
- 不要在生成环境中使用
console.log:应使用结构化日志记录器(Pino、Winston)。
参考资料