知识卡片
同一概念宜保持词汇一致
若fetch、retrieve、get在多个类中其实表达同一取值责任,混用会迫使调用者记住作者或模块偏好。共同词汇让名称形成可预期模式。若返回、状态变化或错误语义确实不同,应保留有意义区别;一致是同一概念用同一词,不是所有方法统一前缀就完成设计。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
- · 第2章 有意义的命名
- · 第3章 函数
原书出处 · 3 处
- 第2章 有意义的命名 2.9 类名 · 查看原书依据
给每个抽象概念选一个词,并且一以贯之
- 第3章 函数 3.5 使用描述性的名称 · 查看原书依据
命名方式要保持一致
- 第17章 味道与启发 17.4 一般性问题(续) · 查看原书依据
如此简单的前后一致
参考来源
- 位置:《代码整洁之道》全书 · 第2章 有意义的命名,spine011单元005;来源项目book-sources,extracted/代码整洁之道/_epub-src/OEBPS/Text/part0009.xhtml。
- 结论依据:原文取值动词和Controller/Manager混用说明无语义差异的词汇切换成本,支持术语与概念稳定对应。未在本机运行示例或改变环境。
- 原始内容:到言到。 2.12 每个概念对应一个词 给每个抽象概念选一个词,并且一以贯之。例如,使用fetch、retrieve和get来给在多个类中的同种方法命名。你怎么记得住哪个类中是哪个方法呢?很悲哀,你总得记住编写库或类的公司、机构或个人,才能想得起