Vercel原生lint与类型检查Deployment Checks将弃用,迁移指南

Vercel原生lint和typecheck Deployment Checks停止新增,2026年11月30日移除,团队需迁移至Vercel CI或自有CI。
Vercel 宣布逐步淘汰原生的 lint 和 typecheck Deployment Checks,新检查不再支持添加,存量检查将运行至 2026 年 11 月 30 日后彻底移除。影响范围仅限于 provider 为 Vercel 的 Lint 和 Typecheck 条目,GitHub Actions 或 Build Command 中已运行的命令不受影响。迁移可选 Vercel CI 或自有 CI 工作流,也可写入 Build Command,但后者会延长构建时间且命令报错即导致部署失败。官方还提供了编码代理提示词,通过 npx skills use vercel/ci@setup 自动配置并提交 PR。团队应尽早迁移并验证失败处理逻辑,避免生产发布的质量门禁出现真空。
Vercel 正在逐步淘汰原生 lint 和 typecheck 的 Deployment Checks。根据官方公告,这两项在部署构建期间并行运行仓库 lint 与类型检查任务的功能将不再支持新增,现有检查会一直运行到 2026 年 11 月 30 日,之后被彻底移除。对于依赖这些检查来保障代码质量的团队来说,这意味着需要提前规划迁移路径,避免生产发布流程出现真空。

弃用范围与时间线
这次调整只影响以 Vercel 为 provider 的 Lint 和 Typecheck 条目。官方明确表示,其他 Deployment Checks 以及在 GitHub Actions 或 Build Command 中已经运行的命令不受影响。换句话说,如果你的质量门禁原本就跑在自定义 CI 流程里,这次变动与你无关;真正需要行动的是那些在项目 Build and Deployment 设置中直接挂载了 Vercel 原生 lint/typecheck 检查的团队。
时间窗口是明确的:新检查无法再添加,存量检查保留至 2026 年 11 月 30 日。这个日期之后,相关任务将不再执行,依赖它们阻断不合格代码的发布流程会随之失效。
Deployment Checks 是 Vercel 部署流水线中的可配置质量门禁机制。在项目设置中,团队可以为每次部署挂载若干检查项,部署流程会在构建阶段并行执行这些检查,只有全部通过才会继续推进到发布环节。Vercel 原生提供的 Lint 和 Typecheck 是最常用的两个内置检查,它们直接调用仓库的 lint 配置和 TypeScript 编译器,无需额外编写 CI 脚本。
Provider 字段决定了检查项的执行来源。当 provider 为 Vercel 时,检查逻辑由平台内置实现;当 provider 指向外部 CI 系统(如 GitHub Actions)时,Vercel 只负责接收并展示这些外部检查的结果。本次弃用仅针对 provider 为 Vercel 的内置 Lint/Typecheck,因此判断某个检查项是否受影响,关键是看它的 provider 归属而非检查名称。
为什么需要迁移,以及迁移到哪里
Vercel 给出的替代方案有两个方向:使用 Vercel CI,或者接入自己的 CI 工作流。官方推荐前者,因为 Vercel CI 是平台原生的持续集成能力,能与现有部署流程更紧密地配合。
对于在 GitHub Actions 中已经配置了 lint 和 typecheck 的团队,其实不需要额外动作——这些命令本来就不在弃用范围内。真正需要迁移的是那些完全依赖 Vercel 内置检查、没有独立 CI 步骤的项目。
Vercel CI 是 Vercel 平台近年推出的持续集成能力,与传统的 Deployment Checks 相比,它把 lint、test、typecheck 等步骤组织成可版本化的工作流配置,运行在部署构建之外的独立环境中。这样质量检查不再与构建过程耦合,失败时可以单独重跑,也不会因为检查命令报错而直接中断整个部署构建。Vercel CI 的配置文件随仓库一起管理,团队可以像对待普通代码一样评审和迭代 CI 逻辑,这与内置 Deployment Checks 在项目设置界面里点选配置的方式有本质区别。
迁移操作要点
第一步是定位受影响项。在项目的 Build and Deployment 设置里,查找 provider 为 Vercel 的 Lint 或 Typecheck 条目,这些就是需要迁移的对象。
第二步是把这些命令搬到新的执行位置。官方提供了两种选择:写入 Build Command,或者在 Vercel CI 中配置。需要留意两者的行为差异——放进 Build Command 会拉长构建时间,而且一旦命令报错,整个部署构建会直接失败。对于用来阻断生产发布的检查,迁移后必须验证新流程在失败时的处理方式是否与原来一致,否则可能出现该拦截却放行的情况。
第三步,Vercel 为使用编码代理的团队准备了一段迁移提示词:让代理执行 npx skills use vercel/ci@setup,按照技能指引选择初始任务、配置 Vercel CI,并自动发起一个 pull request 供审查。这种方式把配置工作交给代理完成,人工只需审核 PR,适合已经将 AI 编程工具纳入日常工作流的团队。
Build Command 是 Vercel 在部署时执行的主构建脚本,通常用于运行框架的构建命令(如 next build)。把 lint 或 typecheck 追加到 Build Command 中,意味着这些检查与构建在同一进程中串行执行,因此会直接增加构建耗时。更关键的是,Build Command 中任何命令返回非零退出码都会导致整个构建失败,部署不会产出新版本。这与 Deployment Checks 的阻断语义一致,但粒度更粗——检查失败和构建失败在日志中混在一起,排查成本更高。
编码代理提示词 是 Vercel 为 AI 编程助手提供的技能调用方式。npx skills use vercel/ci@setup 会拉取名为 vercel/ci@setup 的技能定义,代理据此了解 Vercel CI 的配置规范,然后自动修改仓库文件并提交 PR。这种模式把迁移工作从手动编辑配置转变为审核代理产出的变更,适合已经在工作流中集成 Copilot、Cursor 等工具的团队,但 PR 仍需人工确认配置是否符合项目的实际检查需求。
对开发流程的实际影响
这次弃用反映出一个趋势:平台正在把质量检查的职责交还给开发者自己的 CI 体系,而不是在部署环节内置一套并行的检查机制。对团队而言,短期成本是迁移配置和验证失败处理逻辑;长期看,把 lint 和 typecheck 收敛到统一的 CI 流程里,反而能减少部署设置中的隐式依赖,让质量门禁更透明、更可控。
建议在截止日期前尽早完成迁移,尤其是那些用这些检查作为生产发布最后一道防线的项目。迁移后跑几次失败场景验证,确认拦截行为符合预期,比等到检查被移除后再补救要从容得多。
相关推荐

Claude Mythos 5.2 与 Fable 5.2 错误率异常升高
Claude Mythos 5.2 和 Claude Fable 5.2 出现请求错误率异常升高,官方状态页已标记为调查中。本文梳理事件概况、对开发者的实际影响及应对建议。

ReAct运行时上下文裁剪:Claude Code为何70%就动手
深入解析ReAct运行时的上下文裁剪机制:为什么Claude Code在上下文使用约70%时就触发压缩,工具调用为何占用最多、为何必须成组丢弃,以及代码库为何不需要RAG。基于B站小福哥《分币不掏,学习AI Agent开发》第17节整理。

AI Agent vs LLM:Cursor和Claude Code如何真正工作
深入解析AI Agent与LLM的本质区别:LLM生成代码建议,Agent则通过工具调用修改文件、运行测试。以Spring Boot Bug修复为例,拆解Cursor和Claude Code的工作流、权限控制与验证机制。