知识卡片
可搜索性应匹配名称作用域
跨多处使用的数量或规则,用有含义的名字比散落的7或e更容易定位和核对。短循环中的i可由局部上下文解释,作用域扩大时则应增加辨识信息。名称长度取决于查找和理解需要,不是越长越好;工具的符号搜索有帮助,但名字仍要让结果可辨。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 2 处
- 第2章 有意义的命名 2.5 使用读得出来的名称 · 查看原书依据
名称长短应与其作用域大小相对应
- 第17章 味道与启发 17.6 名称 · 查看原书依据
名称的长度应与作用范围的广泛度相关
参考来源
- 位置:《代码整洁之道》全书 · 第2章 有意义的命名,spine011单元003;来源项目book-sources,extracted/代码整洁之道/_epub-src/OEBPS/Text/part0009.xhtml。
- 结论依据:原文MAX_CLASSES_PER_STUDENT与数字、e对照,并允许局部单字母,直接支持按作用域和搜索噪声取舍,旧算例拼写不当作可执行程序。未在本机运行示例或改变环境。
- 原始内容:以为单字母名称仅用于短方法中的本地变量。名称长短应与其作用域大小相对应[N5]。若变量或常量可能在代码中多处使用,则应赋其以便于搜索的名称。再比较 for (int j=0; j<34; j++) { s += (t[j]*4)/5; }