跳到主要内容
api工厂
工程化

前端 CI/CD 流水线设计:lint→类型检查→测试→构建→部署的分层门禁

api工厂资讯栏目 约 5 分钟阅读
本文由 AI 辅助生成,内容基于公开资讯整理改写,技术细节以官方文档为准。
内容摘要以「单位时间拦截率」排序的五层门禁设计:lint 秒级先行、类型检查独立成层、测试分级执行、构建附加产物检查、部署原子化可回滚,附可直接套用的 GitHub Actions 配置。

结论先行:前端 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 示例

yaml
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),小团队也能拥有完整质量门禁而不必养一条后端流水线。

文章标签

CI/CD质量门禁GitHub Actions自动化

相关产品

api工厂是面向开发者的开放 SaaS 平台:开箱即用的后台管理系统 + 全端 SDK,只需前端开发即可构建小程序、App、H5 与网站。

前端测试VitestPlaywright

前端测试金字塔:Vitest 单元测试 + Playwright E2E 落地

按测试金字塔划分单测、组件测试与 E2E 职责,给出 Vitest 与 Playwright 配置示例、真实商城链路用例、CI 分段策略与闪断治理方法。

工程化约 6 分钟阅读