Vercel 在 2026 年 11 月 17 日宣布,平台原生的 lint 與 typecheck Deployment Checks 進入退場:已無法新增,既有檢查只會運作到 11 月 30 日,之後移除。公告建議改用 Vercel CI 或自己的 CI workflow。這次受影響的是在專案 Build and Deployment 設定中、provider 顯示為 Vercel 的 Lint/Typecheck 檢查;原本已放在 GitHub Actions 或 Build Command 的命令不受這項移除直接影響。
這個期限值得立即處理,因為 Deployment Checks 不只是測試報表。依官方文件,它們可以在 production build 建立後、正式網域套用前阻擋 promotion。若團隊只是刪掉舊檢查,卻沒有把失敗結果重新接回合併規則或部署 promotion,網站仍可能成功建置並上線,只是少了一道原本以為存在的品質閘門。
先確認是不是受影響的原生檢查
到 Vercel 專案的 Build and Deployment 設定查看 Deployment Checks,找出名稱為 Lint 或 Typecheck、provider 為 Vercel 的項目。接著回到 package.json、monorepo task graph 與現有 CI,確認實際執行的命令、Node.js 版本、工作目錄、環境變數及 lockfile。不要只依檢查名稱猜測:lint 可能只掃一個 package,typecheck 也可能依賴先產生 schema 或 client。
再確認舊檢查的阻擋位置。它可能被設為 required Deployment Check,讓 production deployment 等待;也可能同時是 GitHub branch protection 的 required status。遷移後的新 job 名稱、觸發事件與 commit SHA 必須對應相同關卡,否則會出現兩種相反問題:永遠等不到舊 status,或新檢查失敗卻沒有阻止合併與上線。
建立一份最小 inventory:受影響專案、命令、平均時間、secret、cache、required status 名稱、部署環境與負責人。若同一個 repository 連到多個 Vercel project,應逐一核對,不要以為改一個 dashboard 就涵蓋全部。
三種替代方案的取捨
第一種是 Vercel CI。官方頁面在本次查核時將它標示為 public beta,使用 Turborepo task graph,需求包含 Turborepo 2.11.7 以上與 Vercel CLI 64.3.1 以上;目前支援 private GitHub repository 與 Linux 執行環境。適合已使用 Turborepo、希望依變更範圍跳過無關 task,且願意接受 beta 限制的團隊。導入前要確認 public repository、其他 Git provider、非 Linux 工具或既有自架 runner 是否在支援範圍內。
第二種是 GitHub Actions 或既有 CI。優點是 lint、typecheck、unit test 與其他安全掃描可以留在同一條 pipeline,也能使用既有 runner、權限與稽核。Vercel Deployment Checks 可讀取選定的 GitHub Action status;若使用 repository_dispatch,官方文件要求把 status 回報到觸發該部署的 commit,並避免不同 workflow 使用相同 job 名稱造成 Check Run 衝突。這條路設定較多,但最適合已有成熟 CI 的 repository。
第三種是直接把命令放入 Vercel Build Command。公告明確指出這是可行替代,但會增加 build 時間,而且錯誤會讓整個 deployment build 失敗。對單一小型專案,它最容易理解;對 monorepo 或測試時間長的專案,會把編譯、lint 與 typecheck 綁成單一失敗面,也較難獨立重跑。它適合短期保底或簡單專案,不應在沒有時間與費用測量時視為等價替代。
不停掉發布閘門的遷移順序
先在分支建立新 CI,但暫時保留舊 Vercel 原生檢查。固定 Node.js、package manager 與 lockfile,從乾淨環境執行與舊檢查相同的命令。比對至少三類結果:正常 commit 能通過;刻意加入 lint 錯誤會失敗;刻意加入 TypeScript 錯誤也會失敗。若舊檢查與新 job 結果不同,先找出工作目錄、環境變數、generated files 或 tsconfig 差異。
第二步把新 status 接到 branch protection 或 Vercel Deployment Checks,使用唯一且穩定的 job 名稱。建立一個 preview/測試部署,確認新檢查失敗時不會被 promotion;修正後重新執行,確認成功 status 對應的是同一個部署 commit。不能只看 GitHub 綠勾,還要到 Vercel deployment lifecycle 驗證正式網域尚未提前套用。
第三步才移除舊原生檢查,並再次執行失敗與成功路徑。記錄切換日期、新 status 名稱、CI 設定位置與回復方式。若使用 Vercel CI beta,保留一條可切回 GitHub Actions 或 Build Command 的命令;若使用 Build Command,則保留拆回獨立 CI 的 task 定義,避免未來 build 時間失控。
常見的假安全與重複執行
最危險的情況是 repository 的 pull request 有 lint,但直接推到 main 或從其他來源建立的 production deployment 沒有相同閘門。盤點觸發條件時要涵蓋 pull request、main push、手動 redeploy、rollback 與 production promotion。若某些路徑不能執行完整 CI,至少要清楚標示誰能使用、是否需要人工核准。
另一個問題是為了保險把同一條 lint 同時放在 GitHub Actions、Vercel CI 與 Build Command。短期雙跑有助於比對,長期會浪費時間,還可能因工具版本或 cache 不同得到相反結果。遷移完成後應指定一個主要執行者,其他層只消費同一個 status 或執行不同目的的檢查。
11 月 30 日的期限不是「Vercel 不再支援 lint 或 TypeScript」,而是特定原生 Deployment Checks 被移除。最穩健的處理方式,是先確認舊閘門阻擋的位置,再選一個符合 repository、runner 與維運能力的 CI,最後用刻意失敗的 deployment 證明新閘門真的生效。只把命令搬走而沒有驗證 promotion 行為,仍可能在截止日後留下看不見的發布缺口。