大家好,我是云途。
Codex 说“测试通过”,只代表它运行的那项检查通过了。你亲自打开页面以后,仍然可能看到布局错误、入口不明显或文案不对。
同样,页面肉眼看起来正常,也不代表代码没有报错。不同检查负责发现不同问题,所以一项任务通常需要几种检查配合。
这节课会用同一个学习页面说明:每种检查能确认什么,还不能确认什么。
这节课要完成什么
- 分清 lint、类型、构建、测试与真实操作;
- 为任务选择最小但完整的证据组合;
- 识别“测试通过所以全部完成”的错误结论;
- 记录环境、路径和未覆盖项;
- 能审查 Codex 对测试结果的解释。
五种检查,各自负责什么
静态检查
发现语法、规范、无障碍规则和部分类型问题,不运行真实用户流程。
构建
证明项目能在当前配置生成产物,不能证明每个页面体验正确。
自动测试
证明预先写下的断言成立;没有断言的行为不会自动得到证明。
真实操作
证明指定环境和路径中,用户动作得到观察到的结果。
业务与视觉核对
证明内容事实、品牌判断、层级与真实业务规则符合要求。
同一个课程目录需要哪些证据
要求:17 个路由存在
证据:逐路由渲染测试
要求:折叠状态可操作
证据:鼠标 + 键盘真实操作,aria-expanded 检查
要求:只有当前章节有面板
证据:01、02、14、17 节视觉复核
要求:手机无横向溢出
证据:390×844 真实视口 + scrollWidth 比较
要求:课程内容准确
证据:课程计划、文章真源与官方资料核对先读测试到底断言了什么
测试名叫“课程页面测试”,不代表它检查了整篇课程。打开测试文件,看输入、环境、断言和失败信息。
- 它访问了哪些路由;
- 只检查状态码还是也检查内容;
- 是否执行客户端交互;
- 是否使用真实浏览器;
- 是否覆盖手机和登录状态;
- 是否可能因缓存或 mock 得到假阳性。
亲自操作时,要写清环境和步骤
环境:本地 v4,未登录,Chrome
视口:1440×1000 / 390×844
起点:/learning/codex/what-is-codex
动作:收起课程 → 展开模块四 → 打开第 14 节 → 查看右侧本文目录
结果:URL 正确;模块四默认展开;第 14 节唯一选中;右侧目录存在;无横向溢出
控制台:0 error
还没检查:Safari、登录状态、慢网六种常见的错误证明
- lint 通过,就说页面功能通过;
- 构建通过,就说全部路由都能访问;
- 单元测试通过,就说真实浏览器交互通过;
- 桌面截图正常,就说响应式完成;
- 使用 mock 数据通过,就说生产业务正确;
- 只报告通过项,不报告警告、跳过项和未覆盖环境。
根据改动风险选择检查方法
内容改动重点检查事实和页面显示;共享组件改动要顺便检查所有使用它的页面;交互改动要亲自用鼠标、键盘和手机尺寸操作;涉及生产环境或业务数据时,还要准备快照、隔离副本和上线后的复查。
可复制提示词
请根据本次改动列出检查表。每一条完成要求都要写明:用什么方法检查、检查结果是什么、还有哪些情况没有检查。先运行项目原有检查,再亲自操作真实页面。失败、警告、跳过和未覆盖项都要报告。
验证报告要保留失败与限制
命令
完整记录运行的项目内脚本与退出状态。
范围
测试了哪些页面、数据、账号、视口和浏览器。
结果
通过、失败、警告和跳过分别列出。
解释
失败是否与本轮有关,修复或保留的理由是什么。
限制
没有覆盖的生产、设备、账号与异常状态。
视频录制与复习提纲
- 让同一页面依次通过五层验证;
- 打开测试文件阅读真实断言;
- 演示构建通过但交互仍失败;
- 记录桌面与手机真实路径;
- 为三种不同风险任务选择验证组合;
- 写一份包含未覆盖项的报告。
知道证据的边界,才能知道任务是否真的完成
- 我能说出每类检查证明什么;
- 我阅读了测试的真实断言;
- 我为交互完成了真实操作;
- 我记录了环境、路径和视口;
- 我没有隐去失败、警告和跳过项;
- 我说明了仍未覆盖的状态。