知识卡片
命名困难可提示职责混合
反复尝试描述函数的名字,可以检验自己是否知道它负责什么。若名称总要串联许多不相干动作,应回看是否混合了层次或责任;集中目的后,名字常更容易贴合。命名困难只是调查线索,领域概念陌生或词汇不统一也会造成困难,不能凭名字长就判定函数应拆。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
- · 第3章 函数
原书出处 · 1 处
- 第3章 函数 3.5 使用描述性的名称 · 查看原书依据
选择描述性的名称能理清你关于模块的设计思路
参考来源
- 位置:《代码整洁之道》全书 · 第3章 函数,spine012单元004;来源项目book-sources,extracted/代码整洁之道/_epub-src/OEBPS/Text/part0010.xhtml。
- 结论依据:原文把追索名称与改善重构联系,支持用命名过程反查设计;同章长描述名建议说明长度本身不是罪证。未在本机运行示例或改变环境。
- 原始内容:称,直至找到最具有描述性的那一个为止。 选择描述性的名称能理清你关于模块的设计思路,并帮你改进之。追索好名称,往往导致对代码的改善重构。 命名方式要保持一致。使用与模块名一脉相承的短语、名词和动词给函数命名。例如,includeSetupAndTear