名副其实:如果名称需要注释来补充,那就不算是名副其实;
对常量操作,常量的意义是什么?数组下标条目的意义是什么?对于返回值,该如何使用?
避免误导:避免使用与本意相悖的词;
做有意义的区分:添加数字系列或废话是无意义的区分;
使用读得出来的名称;
使用可搜索的名称:单字母名称和数字常量很难在一大篇文字中找出来;
避免使用编码:匈牙利语标记法(设置类型)、成员前缀、接口和实现;
避免思维映射:不应当让读者在脑中把你的名称翻译为他们熟知的名称;
类名:类名和对象名应该是名词或名词短语,避免使用Manager、Processor、Data、Info这样的类名;
方法名:方法名应该是动词或动词短语,属性访问器、修改器和断言加上get、set、is前缀;
重载构造器时,使用描述了参数的静态工厂方法名;可以将构造器设置为private,强制使用这种命名手段;
别耍宝:名称别耍宝,言到意到,意到言到;
每个概念对应一个词:给每个抽象概念选一个词,并且一以贯之;
别用双关语:避免将同一单词用于不同目的;
使用解决方案领域名称,使用源自所涉问题领域的名称;
添加有意义的语境:很少有名称能自我说明的,所以需要:用有良好命名的类、函数或名称空间来放置名称,给读者提供语境;或者给名称添加前缀;
只要短名称足够清楚,就比长名称好,别给名称添加不必要的语境;
本文探讨了编程中命名的重要性,提供了实用的命名建议,包括名副其实、避免误导、做有意义的区分等原则,旨在帮助程序员提升代码质量和可读性。
2592

被折叠的 条评论
为什么被折叠?



