用途:为 Next.js 项目提供 Vercel 部署管理流程。
主要能力:
- 部署流程:向 main 推送触发生产部署(构建→部署→就绪并自动分配域名);向功能分支推送触发预览部署,自动生成预览 URL 并在 PR 中评论预览链接。
- 项目配置:通过 vercel.json 设置 framework、buildCommand、outputDirectory、installCommand、regions 及安全响应头(如 X-Frame-Options、X-Content-Type-Options、Referrer-Policy)。
- 环境变量:生产密钥放 Vercel 控制台,客户端变量用 NEXT_PUBLIC_ 前缀,可使用共享变量组,禁止提交 .env(仅提交 .env.example)。
- 分支配置:在控制台设置生产分支(如 main),非生产分支自动生成预览,可在设置中通过 Ignored Branches 忽略 dependabot、renovate、docs 等分支。
- 构建排障:针对模块未找到、内存超限、构建命令退出码 1、函数调用失败、ENOENT 等给出排查方向;本地可用 npm run build、npx next build、npm run start、vercel build --prod 复现。
- 日志与监控:vercel logs <deployment-url>、vercel logs --tail,控制台可查看构建、函数与边缘函数日志;可开启 Speed Insights 与 Web Analytics。
- 回滚:vercel rollback、vercel rollback <deployment-id>,或在控制台将指定部署提升为生产。
适用场景:Next.js 项目在 Vercel 上的持续部署、预览环境验证、环境隔离与故障回滚。
限制:具体步骤依赖 Vercel 控制台配置,资料未提供 CLI 安装命令、定价、配额、平台支持范围及与其他框架的兼容性说明。