知识卡片
视觉差异也影响名称辨别
只有中间几个字母不同的长名称,或l、O与1、0混用,会让人选错变量或接口。应让区别落在清楚的角色词上,而不是要求后来者记住特殊字体。名称在常用编辑器与检索结果中都应容易辨认;这解决辨别成本,不代替功能和类型检查。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
- 第2章 有意义的命名 2.3 避免误导 · 查看原书依据
提防使用不同之处较小的名称
参考来源
- 位置:《代码整洁之道》全书 · 第2章 有意义的命名,spine011单元002;来源项目book-sources,extracted/代码整洁之道/_epub-src/OEBPS/Text/part0009.xhtml。
- 结论依据:原文近似Controller名称与l/O例直接展示视觉混淆,并用重命名替代特殊字体约定,支持区别应由名字本身承载。未在本机运行示例或改变环境。
- 原始内容:甚至直接用accounts都会好一些。 提防使用不同之处较小的名称。想区分模块中某处的XYZControllerFor EfficientHandlingOfStrings和另一处的XYZControllerForEfficientSt