提炼接口是围绕职责边界抽象出紧密相关的行为契约,用于支撑依赖倒置、降低耦合、便于多态扩展与测试替换;适用场景包括多类重复实现同组方法、类承担过多角色、测试需模拟部分方法、频繁类型判断等;提炼需经识别契约动词、剥离实现细节、重定向依赖三步;须避免过度拆分、命名脱离业务、忽略演化成本;接口与抽象类、组合协同:接口定义“能做什么”,抽象类解决“怎么做”,组合支持多能力复用。

提炼接口(Extract Interface)是面向对象重构中一项关键操作,它不是简单地把已有类的方法“抄”出来贴成接口,而是围绕职责边界做一次清醒的抽象——把一组紧密相关、可被不同实现共同承诺的行为契约,明确抽离为独立接口。这样做,能直接支撑依赖倒置、降低耦合,并为后续多态扩展与测试替換打下基础。
什么时候该提炼接口
当出现以下信号时,就是提炼接口的合理时机:
- 多个不相关的类实现了相同的一组方法(比如save()、validate()、toDto()),但它们没有继承关系,也不该强行拉进一个父类
- 某个类承担了太多角色,外部模块总在用它完成不同语义的操作(例如既当数据载体、又做业务校验、还负责序列化),导致调用方依赖了大量无关行为
- 单元测试中频繁需要模拟整个类,但只关心其中几个方法——说明这些方法构成了一组可独立契约
- 你发现某段逻辑总在判断if ($obj instanceof Exportable && $obj instanceof Validatable)——这其实是接口职责混杂的警示灯
怎么提炼:三步聚焦法
避免“为接口而接口”,提炼要服务于真实协作场景:
- 识别契约动词:从现有类中圈出被同一类调用方反复使用的若干方法,比如canPublish()、publish()、getPublishError(),它们共同表达“发布能力”这一语义,就可提炼为Publishable接口
- 剥离实现细节:接口里只保留签名和文档注释,不带任何逻辑、属性、构造函数或静态方法;若某方法依赖私有状态,先确认它是否真属于该契约——否则应留在具体类中
- 重定向依赖:将原调用方的类型提示、参数类型、变量声明,从具体类名改为新接口名;例如把function handle(User $user)改为function handle(Authenticatable $user)
常见误区与应对
提炼接口容易滑向形式主义,需警惕几个典型偏差:
- 过度拆分:把getName()和getEmail()硬拆成两个接口。应看调用上下文——如果总有模块同时用这两个方法,它们就属于同一契约
- 命名脱离业务:起名IDataProvider或IEntity,等于没抽象。优先用动词+able结构(如Searchable、Retryable)或领域术语(如Payable、Shippable)
- 忽略演化成本:接口一旦发布给外部使用,修改就牵一发而动全身。初期可加@internal注解,等稳定后再开放;新增方法尽量用默认实现(PHP 8.0+)或版本化接口(如PublishableV2)
和抽象类、组合的关系
提炼接口不是替代其他机制,而是协同工作:
- 接口定义“能做什么”,抽象类解决“怎么做”的共性——比如多个Exportable实现共享formatCsv()逻辑,就可在抽象基类里提供默认实现
- 当一个类需要多个能力(如既是Exportable又是Archivable),用接口组合天然支持,比单继承灵活得多
- 若某能力涉及状态管理(如缓存、连接池),更适合封装为独立服务类,再通过依赖注入交由主类组合使用,而非塞进接口










