知识卡片
避免误解名
内容
名字不仅要表达含义,还要避免常见误读。filter、limit、size 等词若边界不清,会让调用者猜测包含关系和单位;命名时要优先消除歧义,而不是追求好看。
参考来源
- 位置:第3章《不会误解的名字》「filter」「推荐用min/max、first/last、begin/end表示范围」小节(源文件:合集EPUB text/part2700.html)
- 结论依据:原文明确指出filter、size等词是二义性单词,容易让调用者误解其含义或性能特征,命名时应主动想象名字会被如何误解并选择不会误解的表达,直接支持卡片对避免误解名的论述。
- 原始内容:"不会误解的名字是最好的名字——阅读你代码的人应该理解你的本意,并且不会有其他的理解。遗憾的是,很多英语单词在用来编程时是多义性的,例如filter、length和limit……在你决定使用一个名字以前,要吹毛求疵一点,来想象一下你的名字会被误解成什么。"