用途:这是一个用于代码结构决策的技能,依据 Ousterhout《软件设计哲学》的规则,判断两段代码(函数、方法、类、模块、服务)应该放在一起还是分开。目标是选择信息隐藏最好、依赖最少、接口最深的结构;拆分本身有代价:更多接口、胶水代码、相关代码距离变远、重复。仅因长度绝不拆分。
合并的信号:两者共享信息(如读取和解析 HTTP 请求);合并能简化接口(中间交接消失或功能自动化,如把缓冲内置到文件输入);消除重复;两者是连体的(不读另一个就无法理解);按时间顺序拆分但共享知识(读、改、写)属于时间分解,应按知识而非顺序分组;双向一起使用才算(块缓存使用哈希表,但哈希表可独立存在)。
拆分的信号:通用与专用代码混合(通用机制保留,专用代码上移到调用方或下移到插件,如 History 处理通用撤销);各部分真正独立,读者可专注其一无需来回翻看。
拆分方法仅限两种形式:提取子任务(父子可各自独立阅读,子任务最好通用可复用,若来回翻看则撤销拆分);拆成两个公共方法(仅当原方法做了不相关的事且多数调用者只需其一,若调用者必须同时调用并传递状态则不要拆)。一个 100 行、签名简单、逐块可读的深方法是可以的。
层坏味道:透传方法(让调用者直接用下层、重新分配职责或合并类;分发器和同一接口的多个实现没问题);装饰器或包装器(先考虑放入基类、用例、已有装饰器或独立类);透传变量(存入两端共享的对象或上下文对象,避免全局变量);接口镜像表示(按行存储不需要按行 API,深度正来自两者差异)。
输出格式:判定 join 或 split(子任务/两个方法/通用专用)或 keep;规则(具体信号及证据);形态(新签名或模块边界简述)。