知识卡片
不同名称应说明不同角色
copyChars的source/destination说明谁提供数据、谁被写入,比a1/a2更能揭示调用责任。类似CustomerInfo与Customer若没有清楚约定,只是制造多个看似可选的名字。Info、Data等词并非天然无意义;只有当它们确实标识不同层次或内容时才值得保留,不能为通过重名限制随意加字。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 3 处
- 第2章 有意义的命名 2.3 避免误导 · 查看原书依据
如果名称必须相异,那其意思也应该不同才对
- 第15章 JUnit内幕 15.1 JUnit框架(续) · 查看原书依据
我们应该区分这些名称
- 第17章 味道与启发 17.6 名称 · 查看原书依据
说明两个函数之间的区别
参考来源
- 位置:《代码整洁之道》全书 · 第2章 有意义的命名,spine011单元002;来源项目book-sources,extracted/代码整洁之道/_epub-src/OEBPS/Text/part0009.xhtml。
- 结论依据:原文参数方向和Info/Data混淆对照,支持语义角色区分而非数字或废词;原文也允许有意义前缀,故不绝对禁词。未在本机运行示例或改变环境。
- 原始内容:是废话远远不够,即便这足以让编译器满意。如果名称必须相异,那其意思也应该不同才对。 以数字系列命名(a1、a2,……aN)是依义命名的对立面。这样的名称纯属误导——完全没有提供正确信息;没有提供导向作者意图的线索。试看: public static