CI 中的测试

这一课你将能做到

1. 读懂并标注本站 .github/workflows/ci.yml 里 backend / platform 两个 job 的测试命令与顺序
2. 说清 mvn test 与 mvn verify 的差异，并让本地习惯与 CI 严格对齐
3. 解释并行 job、concurrency 取消旧 run、失败阻断合并的工程含义，并画出走测试分轨的草图

为什么要学

个人笔记本上的绿测挡不住两件事：「我忘了跑」和「我机器有特殊配置」。持续集成（CI） 在每次 push / PR 时用干净环境自动跑测试——失败即红，阻止未验证代码进入主线。人话：CI 是团队共享的红绿灯，它比同事更不讲面子，也比你本地环境更干净。

CodeForge 的 ci.yml 是现成范本：backend 跑 mvn -B verify，platform 跑 npm test + npm run build。学完本课，你应能在 PR 页 30 秒内定位红灯来源，并知道「为什么我的测试要这么挂」。写测试的手法在前 10 课；本课讲测试如何成为工程纪律。

没有 CI 时，测试停留在「有纪律的人偶尔跑」；有 CI 后，测试成为默认路径。金字塔策略也在这里落地：CI 里快测必跑，慢测按频率分轨，避免红绿灯变成永远排队的黄灯。

先建立图像

push / PR
    │
    ├─► job backend：  setup-java → mvn -B verify
    └─► job platform： npm ci → npm test → npm run build
              ▲
      两者并行；总时长 ≈ max(两者)，不是相加

concurrency：同一分支新 push 取消旧 run（省分钟）

命令	含义
mvn test	跑 Surefire 快测（*Test）
mvn verify	test + 打包 / JaCoCo report / Failsafe IT 等后续阶段
npm test	前端单元 / 组件测
npm run build	编译打包，放测试后以免白跑

任一 job 失败，PR 不应合并。Checks 是「合并前的最后读者」。

跟着做

步骤 1：打开并标注 ci.yml

一份与 CodeForge 结构一致的带注释样例（细节以仓库真实文件为准）：

name: ci
on:
  push:
    branches: [main]
  pull_request:

concurrency:
  group: ${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true    # 连续 push 只跑最新

jobs:
  backend:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-java@v4
        with:
          distribution: temurin
          java-version: "17"       # 与生产一致
          cache: maven             # 依赖缓存，省下载分钟
      - name: 测试与打包
        run: mvn -B verify
        working-directory: backend
      - name: 上传测试报告
        if: always()               # 红了也要能看报告
        uses: actions/upload-artifact@v4
        with:
          name: surefire-reports
          path: backend/target/surefire-reports/

  platform:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: "20"
          cache: npm
          cache-dependency-path: platform/package-lock.json
      - run: npm ci                # 锁文件为准，比 npm install 可复现
        working-directory: platform
      - run: npm test
        working-directory: platform
      - run: npm run build         # 测试绿了才值得打包
        working-directory: platform