模块 3 · 检查 Codex 的交付

测试与真实操作
分别证明什么

看懂 lint、构建、自动测试和亲自点击页面各自能检查什么,避免只看到一项通过就宣布完成。

预计阅读 28 分钟视频建议 24—30 分钟登录后免费核验于 2026.08.18

大家好,我是云途。

Codex 说“测试通过”,只代表它运行的那项检查通过了。你亲自打开页面以后,仍然可能看到布局错误、入口不明显或文案不对。

同样,页面肉眼看起来正常,也不代表代码没有报错。不同检查负责发现不同问题,所以一项任务通常需要几种检查配合。

这节课会用同一个学习页面说明:每种检查能确认什么,还不能确认什么。

这节课要完成什么

  1. 分清 lint、类型、构建、测试与真实操作;
  2. 为任务选择最小但完整的证据组合;
  3. 识别“测试通过所以全部完成”的错误结论;
  4. 记录环境、路径和未覆盖项;
  5. 能审查 Codex 对测试结果的解释。

五种检查,各自负责什么

静态检查

发现语法、规范、无障碍规则和部分类型问题,不运行真实用户流程。

构建

证明项目能在当前配置生成产物,不能证明每个页面体验正确。

自动测试

证明预先写下的断言成立;没有断言的行为不会自动得到证明。

真实操作

证明指定环境和路径中,用户动作得到观察到的结果。

业务与视觉核对

证明内容事实、品牌判断、层级与真实业务规则符合要求。

同一个课程目录需要哪些证据

证据矩阵MATRIX
要求:17 个路由存在
证据:逐路由渲染测试

要求:折叠状态可操作
证据:鼠标 + 键盘真实操作,aria-expanded 检查

要求:只有当前章节有面板
证据:01、02、14、17 节视觉复核

要求:手机无横向溢出
证据:390×844 真实视口 + scrollWidth 比较

要求:课程内容准确
证据:课程计划、文章真源与官方资料核对

先读测试到底断言了什么

测试名叫“课程页面测试”,不代表它检查了整篇课程。打开测试文件,看输入、环境、断言和失败信息。

  1. 它访问了哪些路由;
  2. 只检查状态码还是也检查内容;
  3. 是否执行客户端交互;
  4. 是否使用真实浏览器;
  5. 是否覆盖手机和登录状态;
  6. 是否可能因缓存或 mock 得到假阳性。

亲自操作时,要写清环境和步骤

别人可以照着复查的记录QA
环境:本地 v4,未登录,Chrome
视口:1440×1000 / 390×844
起点:/learning/codex/what-is-codex
动作:收起课程 → 展开模块四 → 打开第 14 节 → 查看右侧本文目录
结果:URL 正确;模块四默认展开;第 14 节唯一选中;右侧目录存在;无横向溢出
控制台:0 error
还没检查:Safari、登录状态、慢网

六种常见的错误证明

  1. lint 通过,就说页面功能通过;
  2. 构建通过,就说全部路由都能访问;
  3. 单元测试通过,就说真实浏览器交互通过;
  4. 桌面截图正常,就说响应式完成;
  5. 使用 mock 数据通过,就说生产业务正确;
  6. 只报告通过项,不报告警告、跳过项和未覆盖环境。

根据改动风险选择检查方法

内容改动重点检查事实和页面显示;共享组件改动要顺便检查所有使用它的页面;交互改动要亲自用鼠标、键盘和手机尺寸操作;涉及生产环境或业务数据时,还要准备快照、隔离副本和上线后的复查。

可复制提示词

请根据本次改动列出检查表。每一条完成要求都要写明:用什么方法检查、检查结果是什么、还有哪些情况没有检查。先运行项目原有检查,再亲自操作真实页面。失败、警告、跳过和未覆盖项都要报告。

验证报告要保留失败与限制

命令

完整记录运行的项目内脚本与退出状态。

范围

测试了哪些页面、数据、账号、视口和浏览器。

结果

通过、失败、警告和跳过分别列出。

解释

失败是否与本轮有关,修复或保留的理由是什么。

限制

没有覆盖的生产、设备、账号与异常状态。

视频录制与复习提纲

  1. 让同一页面依次通过五层验证;
  2. 打开测试文件阅读真实断言;
  3. 演示构建通过但交互仍失败;
  4. 记录桌面与手机真实路径;
  5. 为三种不同风险任务选择验证组合;
  6. 写一份包含未覆盖项的报告。
完成检查

知道证据的边界,才能知道任务是否真的完成

  • 我能说出每类检查证明什么;
  • 我阅读了测试的真实断言;
  • 我为交互完成了真实操作;
  • 我记录了环境、路径和视口;
  • 我没有隐去失败、警告和跳过项;
  • 我说明了仍未覆盖的状态。

官方依据与延伸阅读

Codex 使用案例:测试与质量