用途:该技能面向 Next.js 应用的构建与启动流程,帮助处理构建错误、验证生产构建并管理开发服务器。
主要能力与用法: 开发环境使用 npm run dev,或使用 Turbopack 加速的 npm run dev:turbo,默认端口 3000,支持热重载、错误浮层与快速刷新。 生产构建使用 npm run build,Vercel 优化构建使用 npm run build:vercel,输出到 .next 目录,通常耗时 20-60 秒。 生产启动使用 npm run start,默认端口 3000,需要 NODE_ENV=production。 部署后可用 npm run cache:purge 清理 CDN 与 Data Cache(需 Vercel CLI 并登录),也可在 Vercel 面板 Settings → Caches 中清理。推荐流程为部署后再执行清理。
构建流程:构建包含自动前置步骤,运行 scripts/create-react-cache-polyfill.js 生成 react/cache 兼容 polyfill,用于 Next.js 16 兼容。next.config.js 中配置了 TypeScript 构建错误忽略(临时)、生产环境移除 console、Vercel 部署优化、ANALYZE=true 启用包分析器,以及通过 NEXT_PUBLIC_ASSETS_VERSION 实现缓存失效。
常见问题处理:TypeScript 错误可用 npx tsc --noEmit 检查;内存不足可用 NODE_OPTIONS="--max-old-space-size=4096" npm run build;模块解析错误可删除 .next 与 node_modules 后重装再构建。
验证清单:构建无错误、无严重警告、.next 目录生成、生产服务器可启动、页面无运行时错误、环境变量正确加载。
限制:资料未提供具体收费、价格、平台支持范围及效果数据;部分配置(如忽略 TypeScript 错误)为临时方案。