用途:当 Python 代码的可读性、层次结构或重复度影响理解和维护,又不能改变既有行为时,使用此技能做局部、可证明安全的简化。目标不是写得更短,而是在保留功能、输出、副作用、异常与公开接口的前提下降低复杂度。
主要能力:消除重复代码(提取公共函数、参数化相似函数);简化条件逻辑(用 Guard Clause 提前返回替代深层嵌套,用字典映射替代长 if-elif 链,用 match-case 处理结构化分支);简化集合操作(推导式替代循环,使用 sum、any、all、max 等内置函数);简化函数设计(移除无语义中间变量、用 dataclass 替代样板类);消除魔法值(命名常量、枚举);用 with 重构资源管理;用 | 合并字典(3.9+)、match-case(3.10+)。
使用方式:先确定最小可安全修改范围,判断主要问题是重复、嵌套、分支膨胀还是样板代码,选择最清晰的局部改法,保持边界条件与失败路径一致,再用测试、ruff 和 basedpyright 验证。它与其他 Python 技能分工:python-code-quality 负责格式化与 lint,python-best-practices 负责广义设计与性能,python-code-review 负责整体审查。
适用场景:重复校验/转换/分支逻辑、条件嵌套过深、值分发型长分支、无意义中间变量、样板代码过多、手写循环啰嗦、魔法数字字符串。
限制:不用于跨模块重构、架构重设计、以性能优化为主的改动,或会改变 API、数据结构、异常协议与业务行为的修改;不做得仓库级顺手整理;不为减少行数引入更晦涩写法;无法证明语义不变时停止简化并保留原实现。应避免过度抽象、把带副作用的分支强行改成字典、把所有类改成 dataclass。