结论先行:前端 CI/CD 的正确形态是「分层门禁、快速失败」——lint 与格式检查放最前(秒级),类型检查次之(十秒级),单元测试居中(分钟级),构建与产物检查随后,部署只在全部绿灯后执行;每一层只回答一个问题,任何一层失败立即终止,不浪费后续算力。 本文给出一套可直接套用的五层流水线设计与 GitHub Actions 示例。
分层门禁总览
| 层 | 回答的问题 | 典型工具 | 失败策略 |
|---|---|---|---|
| lint/格式 | 代码是否符合约定 | ESLint、Biome | 立即失败 |
| 类型检查 | 类型是否自洽 | tsc --noEmit | 立即失败 |
| 测试 | 行为是否正确 | Vitest、Playwright | 立即失败 |
| 构建 | 能否产出可部署产物 | Vite build | 立即失败 |
| 部署 | 能否安全上线 | 静态托管/CDN | 可回滚 |
排序依据是「单位时间拦截率」:lint 最便宜且拦截量最大,放最前;e2e 最贵,只在预发布环境或主干 nightly 跑,不阻塞每个 PR。
第一层:lint 与格式
命令要显式、可复现:eslint . --max-warnings=0 把警告也当门禁,避免「警告越攒越多」;用 Biome 的团队跑 biome ci,只读模式天然适合流水线。格式检查与 lint 修复分离:CI 只检查不写文件,修复发生在本地钩子。monorepo 中这一层配合 Turborepo/Nx 的受影响分析,只检查变更包,耗时可以压到秒级。
第二层:类型检查
tsc --noEmit 独立成层,不要依赖构建工具「顺带」检查——Vite 的 esbuild 转译不做类型检查,构建成功不代表类型正确。大仓库开启 incremental 并缓存 tsbuildinfo;类型检查与 lint 可并行执行,两者互不依赖。注意 CI 与本地 TypeScript 版本必须一致,锁文件是唯一事实来源。
第三层:测试
单元测试用 vitest run(非 watch 模式),按模块拆分并行;覆盖率设阈值但别迷信数字,核心业务路径的断言质量比百分比更重要。组件测试与 e2e 分层:PR 阶段跑单元与组件测试,e2e 冒烟集在预发布环境跑,全量 e2e 放主干定时任务。测试失败要输出可读报告(JUnit XML 或 HTML artifact),让开发者一眼定位。
第四层:构建与产物检查
vite build 之后追加产物门禁:用 size-limit 或 bundlesize 检查关键 chunk 体积,超预算即失败;校验产物中不含 .map 文件泄露(除非策略允许)、不含硬编码密钥。构建产物上传为 artifact,供部署层与后续排查复用,保证「测的就是发的」。
第五层:部署与回滚
PR 合并后先部署到预览环境跑冒烟,再上生产;静态站点优先原子发布(整目录切换或版本化路径 + 指针切换),避免半新半旧。回滚方案要在上线前演练:保留最近 N 个版本产物,回滚只是切指针。部署凭据用 OIDC 短期令牌,按环境隔离,绝不把长期密钥放进流水线变量。
GitHub Actions 示例
name: frontend-ci
on:
pull_request:
jobs:
quality:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: pnpm/action-setup@v4
- uses: actions/setup-node@v4
with:
node-version: 24
cache: 'pnpm'
- run: pnpm install --frozen-lockfile
- run: pnpm lint
- run: pnpm exec tsc --noEmit
- run: pnpm test
- run: pnpm build依赖缓存与 --frozen-lockfile 是标配;更复杂的仓库可把 lint/类型/测试拆成并行 job,用 needs 汇聚到构建与部署。
本地与 CI 的一致性
门禁最常见的失效不是配置错,而是「本地过了 CI 挂」。三条纪律可以消除绝大多数此类问题:本地钩子与 CI 跑同一组 scripts,禁止各写一套命令;Node 与包管理器版本用 .nvmrc、packageManager 字段或 engines 显式锁定,CI 读取同一声明;环境变量差异显式化,CI 特有的变量在本地用 .env.example 说明。此外给流水线设置总时长预算(如 PR 门禁不超过 10 分钟),超预算就优化分层与缓存,而不是放宽门禁——门禁一旦可以「跳过」,就会永远被跳过。
前端团队的流水线可以很短
这套五层模型有个隐含红利:如果后端能力直接采用 api工厂(https://www.it120.cc/)这类托管平台,流水线里就没有后端编译、数据库迁移、服务镜像等环节,五层全部是前端任务,总时长可控、维护成本极低。会员、商品订单、微信支付等能力由平台现成接口提供,免费会员 0 元/年(非商业)、专业版 399 元/年(https://www.it120.cc/price.html),小团队也能拥有完整质量门禁而不必养一条后端流水线。