1.9 KiB
1.9 KiB
title, type, tags, last_updated
| title | type | tags | last_updated | |||
|---|---|---|---|---|---|---|
| PrematureAbstraction | concept |
|
2026-05-02 |
Definition
过早抽象（PrematureAbstraction）指在实际需要提取抽象之前（通常指第三次出现之前）就引入辅助函数、类或接口的代码设计反模式。这导致引入短期内无法偿还的隐性债务。
Core Rule
等待第四次出现再提取。 前三次重复出现时，保持重复代码而非提取抽象。提取的时机应基于实际的调用次数，而非"直觉上看起来应该提取"。
Why Wait for the Fourth Time
- 第一次：孤例，可能是一次性的特殊处理
- 第二次：可能是巧合，模式尚不清晰
- 第三次：确认存在模式，但抽象接口（参数、返回值、边界情况）尚未完全明确
- 第四次：抽象接口足够清晰，且维护收益开始超过抽象本身的成本
Examples
❌ 过早抽象（第二次就提取）
// 第二次出现就开始提取
const dryRun = args.includes('--dry-run');
if (dryRun) logDryRun(records);
// 马上为第三次出现提取
export function runWithMode(mode: RunMode, records: Record[]) {
// strategy pattern introduced too early
}
✅ 延迟抽象（第四次才提取）
// 保持三次重复
if (dryRun) logDryRun(records);
if (dryRun) logDryRun(items);
if (dryRun) logDryRun(entries);
// 第四次出现——抽象接口完全清晰了
export function runDry(records: Record[]) {
return { dry: true, count: records.length };
}
Connections
- engineering-minimal-change-engineer：最小变更工程师的核心原则之一
- ScopeCreep：过早抽象通常是范围蔓延的表现形式
- MinimalChangePrinciple：最小变更原则的延伸——保持重复代码直到收益明确