测试补齐与代码整洁化

功能跑通只是第一步，用回归测试锁住行为、用克制的整洁化改善可维护性，才让代码长期可读、可安全演进。本节区分"补测试"与"做整洁化"两件事的目标、优先级与验收标准，避免为覆盖率堆砌无效用例，也避免在整洁化中悄悄改变行为。

一、测试补齐要覆盖什么

测试类型	目标	优先补齐对象
主路径正确性	核心输入得到预期主结果	新实现或新修改的主要流程
边界与异常分支	非法、缺失、失败输入行为合理	容易出错、历史上出过缺陷的分支
回归保护	本次修复的缺陷不再复现	刚修复的 Bug 对应场景
关键决策逻辑	条件判断、转换规则按预期工作	分支多、规则复杂的模块
对接契约	输入输出结构与调用方预期一致	被多处调用的公共函数

二、补齐测试的优先级原则

1. 风险优先：优先覆盖后果严重、变更频繁、依赖外部输入的路径，而非均匀铺开。
2. 先回归后装饰：先为新改动与缺陷补行为级检查，再补充辅助性用例。
3. 断言要有意义：每个用例应验证具体结果或关键行为，不写只"调用不报错"的空断言凑数。
4. 用例独立可重复：用例之间不依赖执行顺序与隐藏状态，失败时能单独定位。
5. 匹配真实行为：测试应锁定规格确认的行为；若发现规格不清，先澄清再固化，而非把缺陷行为写成预期。

三、代码整洁化的可做与不可做

可做（不改变行为）	应避免（易改变行为或扩大范围）
提取重复片段、统一命名与注释	借整洁之名同时修 Bug 或加新逻辑
拆分过长函数、明确职责归属	无测试保护下大范围搬移与重写
收敛散落的重复常量与魔法值	删除未经引用确认的"死代码"
统一错误处理与返回结构风格	同时修改对外签名或默认行为
去除临时代码与无用注释	引入新依赖或切换实现技术栈

四、测试与整洁化的联合验收

验收项	合格标准
测试结果	项目可用检查全部通过，无被跳过或弱化的关键用例
行为一致性	整洁化后主路径与边界行为与改动前基线一致
改动聚焦	git diff 内容集中在测试补充与结构改善，无逻辑夹带
可读性提升	命名、结构、重复度改善且有实际依据，不追求无意义格式化
依赖与兼容	未新增非必要依赖、未破坏既有调用方契约
可提交性	测试与结构改动可分节点提交，历史清晰、便于回退

五、FAQ

问题	处理建议
现有项目缺测试要不要一次补全	围绕当前改动与高风险路径增量补齐，不做脱离价值的大规模补测。
为了让测试通过修改了实现逻辑	先确认是实现错误还是测试预期错误；若属行为变更应单独评估，不与测试补充混做。
整洁化后感觉代码更长了	以可读性与职责清晰度为准；刻意压缩或过度拆分都不是目的，重复收敛与命名清晰才是。
如何处理疑似死代码	先检索直接与间接引用、动态调用与配置入口，确认无使用后再单独删除并保留回退点。

六、动手练习

• 练习：选取本轮功能/缺陷改动，按优先级补 2–3 条有断言的回归检查，再做一次不改变行为的重复收敛或命名整理；提交前对照联合验收表逐项确认。