Vercel推出仅PR预览构建预设,跳过无PR分支构建

Vercel 新增预设:仅对有关联开放 PR 的分支构建预览,节省构建资源。
Vercel 为预览部署引入了一项新的 Ignored Build Step 预设「Only build previews for pull requests」,允许团队跳过没有开放拉取请求(PR)的分支的预览构建,从而节省构建资源。该预设会自动填充忽略命令,使项目在分支无关联开放 PR 时跳过预览构建,而生产部署和已有开放 PR 的分支预览构建不受影响。对于 GitHub 和 GitLab 项目,被跳过的预览部署会在消耗任何 Build CPU Minutes 之前取消。启用路径简单:进入 Deployments > Configuration,在 Ignored Build Step 区域选择该预设并保存即可。这项改进将预览构建与代码审查流程对齐,减少不必要的构建消耗和部署列表噪音,尤其适合频繁产生临时分支或接收外部贡献的项目。
Vercel 为预览部署引入了一项新的 Ignored Build Step 预设:「Only build previews for pull requests」。这项功能让团队可以跳过没有开放拉取请求(PR)的分支的预览构建,从而节省构建资源。
功能概览:什么是“仅PR预览构建”预设?
根据 Vercel 官方发布的信息,这个预设会自动填充忽略命令,使项目在以下场景中跳过预览构建:
- 分支没有关联的开放拉取请求时,不触发预览构建。
- 生产部署不受影响,始终会构建。
- 有开放拉取请求的分支,预览构建照常进行。
对于使用 GitHub 和 GitLab 的项目,被跳过的预览部署会在消耗任何 Build CPU Minutes 之前取消。这意味着团队不会为那些“无效”的预览构建付费或消耗额度。

预览部署(Preview Deployment) 是 Vercel 的核心能力之一:每次向 Git 仓库推送代码(非生产分支),Vercel 都会自动构建并部署一个独立的、带唯一 URL 的环境,供团队在合并前查看效果。它通常与 Pull Request 关联,但传统上任何分支推送都会触发。Ignored Build Step 则是 Vercel 提供的一个可配置命令钩子:在构建开始前执行该命令,若其退出码为 0 则跳过构建,非 0 则继续。这个机制让团队可以用脚本自定义“什么情况下不构建”,例如仅当特定文件变更时才构建。新预设本质上就是官方预置了一段忽略命令,根据分支是否关联开放 PR 来决定是否跳过,从而省去手动编写脚本的麻烦。
如何启用:三步配置
启用该预设的操作路径非常直接:
- 进入项目的 Deployments > Configuration 页面。
- 在 Ignored Build Step 区域,从 Behavior 菜单中选择 Only build previews for pull requests。
- 点击 Save 保存设置。
保存后,系统会自动填充忽略命令,无需手动编写脚本。官方文档中提供了更详细的 Ignored Build Step 说明,供需要自定义行为的团队参考。
为什么这个功能值得关注?
在典型的开发工作流中,开发者经常会将分支推送到远程仓库以触发 CI/CD 流程,但并非每次推送都需要预览部署。例如,频繁推送的临时分支、实验性分支或仅用于备份的分支,如果每次都触发预览构建,会浪费构建资源和时间。
Vercel 的这项预设将“预览构建”与“拉取请求”绑定,更贴近现代代码审查流程:只有当你准备合并代码、需要团队评审时,才生成预览环境。这不仅能降低构建成本,也能减少部署列表中的噪音,让团队更聚焦于真正需要评审的变更。
有意思的是,该预设仅影响预览部署,生产部署始终会构建。对于依赖预览环境进行设计评审或 QA 的团队,只要保持 PR 开放,预览构建就不会被跳过。
Build CPU Minutes 是 Vercel 对构建资源消耗的计量单位,指构建过程中占用的 CPU 时间(以分钟计)。不同套餐包含一定的免费额度,超出后按用量计费。预览构建同样消耗 Build CPU Minutes,因此频繁推送临时分支会产生可观成本。该预设的关键在于:对于 GitHub 和 GitLab,Vercel 能在构建启动前通过 API 查询分支是否有关联的开放 PR,若没有则直接取消部署,此时尚未开始消耗 Build CPU Minutes。这区别于构建中途失败或取消——后者可能已产生部分消耗。因此,该预设实现的是“零成本跳过”,而非“构建后丢弃”。
与现有工作流的整合建议
如果你的团队已经在使用 Vercel 的预览部署进行协作,可以结合以下实践:
- 在 PR 模板中提醒:确保开发者在需要预览时及时打开 PR,而不是仅推送分支。
- 结合分支保护规则:在 GitHub 或 GitLab 中设置分支保护,要求 PR 才能合并,与 Vercel 的预设形成互补。
- 监控构建用量:在 Vercel 仪表盘中观察 Build CPU Minutes 的变化,评估预设带来的节省效果。
对于开源项目或频繁接收外部贡献的仓库,这个预设尤其有用:它可以避免为每个 fork 的推送都生成预览,只有真正发起 PR 时才构建,减轻维护者的资源压力。
分支保护规则(Branch Protection Rules) 是 GitHub/GitLab 提供的仓库管理功能,可强制要求合并前必须通过 PR、获得指定数量的审批、通过状态检查等。将 Vercel 的“仅 PR 预览构建”预设与分支保护结合,能形成一致的流程约束:分支保护确保代码变更必须走 PR,而 Vercel 预设确保只有 PR 才生成预览。两者互补,避免开发者绕过 PR 直接推送分支却仍产生预览部署的情况。对于开源项目,还需注意 fork 工作流:外部贡献者通常从 fork 推送分支并发起 PR,该预设能有效阻止为 fork 的每次推送构建预览,仅当 PR 打开后才构建,减轻维护者资源压力。
总结
Vercel 的“仅PR预览构建”预设是一个小而实用的改进,它把预览构建的触发条件与代码审查流程对齐,帮助团队减少不必要的构建消耗。配置简单,无需编写自定义命令,适合大多数使用 GitHub 或 GitLab 的 Vercel 项目。如果你的项目经常产生大量临时分支的预览部署,不妨在 Deployments > Configuration 中尝试开启这个预设。
相关推荐

间谍蜜罐训练内幕:情感解离与锚定技术
间谍如何被训练执行蜜罐任务?一位受训者披露情感解离、香水与关键词锚定、目标照片绑定等心理学技术,解析条件反射如何被用于情报行动,并揭示这套机制在日常生活营销中的类似应用。

前沿AI风险管理:从训练到部署的全链路实践
OpenAI系统阐述前沿AI风险管理框架:从训练阶段的模型对齐,到部署阶段的沙箱隔离与阻断式防护,再到部署后的持续监控,构建贯穿模型全生命周期的分层风险控制体系。

Databricks推出Genie Migrate,简化Serverless迁移
Databricks 发布 Genie Migrate for Serverless,帮助用户将既有工作负载迁移到 Serverless 计算。本文解析该迁移工具的定位、对用户的实际意义以及尚未明确的细节。