知识卡片
名称不应暗示不存在的能力
accounts若只是一些账号,名称就不应让人误以为具有某种列表顺序或接口。类型词、平台缩写和领域词都可能给读者既有暗示,应检查它是否符合真实用途。即使底层确是List,也常可用任务语义替代具体容器名;规则关注误导,而不是必须把实现类型编码进名称。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
- 第2章 有意义的命名 2.3 避免误导 · 查看原书依据
别用accountList来指称一组账号
参考来源
- 位置:《代码整洁之道》全书 · 第2章 有意义的命名,spine011单元002;来源项目book-sources,extracted/代码整洁之道/_epub-src/OEBPS/Text/part0009.xhtml。
- 结论依据:原文accountList及脚注说明容器名会诱导类型判断,支持按真实语义命名,未要求即使List也必须保留后缀。未在本机运行示例或改变环境。
- 原始内容: [2] ,但那也可能会提供错误信息。 别用accountList来指称一组账号,除非它真的是List类型。List一词对程序员有特殊意义。如果包纳账号的容器并非真是个List,就会引起错误的判断 [3] 。所以,用accountGroup或bunc