第1章 识别重复夹具：从模式到候选标记

在UI自动化测试中，夹具（Fixture）重复是测试代码膨胀的首要根源。同一份前置条件代码在多个测试类中反复出现，不仅增加维护成本，还导致环境配置不一致、用例执行结果不稳定。本章从重复模式分类、自动化扫描定位到候选标记，建立完整的识别体系。

1.1 重复夹具的典型模式

通过对不同规模测试代码库（10万～100万行）的实证分析，我们归纳出四种高频重复模式。检测难度从低到高排列：

1.2 使用代码扫描工具定位重复

手工审查难以覆盖大型代码库，推荐采用两阶段扫描策略：先用通用重复代码检测工具做全量快扫，再用基于 AST 的自定义脚本做精确过滤。

阶段一：jscpd 全量扫描

# 全局安装 jscpd
npm install -g jscpd

# 对 tests 目录执行重复分析
# --min-lines: 最少重复行数，过滤偶然相同
# --min-tokens: 最少重复  数，控制灵敏度
# --format: 指定语言，提高 AST 精确度
jscpd --patterns "**/tests/**/*.py" \
      --min-lines 5 \
      --min-tokens 50 \
      --format "python" \
      --output "jscpd-report.json"

阶段二：AST 精确过滤

针对 jscpd 输出的候选结果，使用 Python AST 工具提取夹具函数体签名，剔除变量名差异导致的误报：

# fixture_duplicates.py
# 基于 AST 的夹具重复模式精检测
import ast
import glob
import json
from collections import defaultdict

def extract_fixture_sig(node):
    """提取夹具函数的方法体 AST 签名"""
    if isinstance(node, ast.FunctionDef) and \
       node.name.lower() in ('setup', 'teardown', 'set_up', 'tear_down',
                             'beforeeach', 'aftereach'):
        # 忽略变量名，只保留结构
        return ast.dump(node.body)
    return None

def scan_duplicates(pattern="tests/**/*.py"):
    files = glob.glob(pattern, recursive=True)
    sig_map = defaultdict(list)
    for fp in files:
        with open(fp, 'r', encoding='utf-8') as f:
            try:
                tree = ast.parse(f.read())
            except SyntaxError:
                continue
        for node in ast.walk(tree):
            sig = extract_fixture_sig(node)
            if sig:
                sig_map[sig].append({
                    "file": fp,
                    "line": node.lineno,
                    "name": node.name
                })
    # 返回值：签名 → 位置列表（仅保留 >=2 处的重复组）
    result = []
    for sig, locs in sig_map.items():
        if len(locs) >= 2:
            result.append({
                "signature_hash": hash(sig),
                "occurrences": len(locs),
                "locations": locs
            })
    return result

if __name__ == "__main__":
    dups = scan_duplicates()
    # 输出 JSON 供后续标记脚本使用
    with open("fixture-candidates.json", "w") as out:
        json.dump(dups, out, indent=2, ensure_ascii=False)
    print(f"发现 {len(dups)} 组重复夹具候选，结果已写入 fixture-candidates.json")

1.3 标记重复夹具候选

将扫描结果转化为可执行的候选清单，需要经过“分级 → 标注 → 评估 → 入库”四个步骤：

• 候选分级（P0–P3）：P0 为完全复制，P1 为结构重复，P2 为组合重复，P3 为继承冗余。优先级按修复收益降序排列。
• 上下文标注：记录每个候选夹具所在的文件路径、起始行号、结束行号、所属测试类和方法名。
• 影响评估：估算消除重复后减少的代码行数、可合并的测试类数量以及预期的维护工时节省。
• 清单入库：将候选信息写入结构化 JSON 或 CSV 文件，供后续章节的夹具提取与重构环节消费。