首页/开发/代码质量与评审速查/坏味道:神秘命名(Mysterious Name)
重构手法62 条

坏味道:神秘命名(Mysterious Name)

命名没表达意图时先换名:函数、变量、类、模块的名字应说明它做什么或是什么;命名卡壳常意味着职责划分有问题,改名的过程往往揭示设计。

识别看不出用途、需要读实现才明白
手法Rename Variable / Rename Function / Rename Class
延伸命名困难 → 职责可能混杂

示例

示例
// 之前
int d; // 过期天数

// 之后
int daysUntilExpiration;
IDE 的重命名重构是安全的起步动作:跨文件引用一次改全,比手改可靠。

易错点

  • 缩写词堆叠(calcTtlAmt):评审者要靠猜
  • 名字与实现不符时只改名不改行为:误导依然存在,应一并修正

数据来源与参考

  • 《重构》第 2 版 · 第 3 章(Bad Smells · Mysterious Name)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌