有意义的命名

在编程过程中,命名随处可见。我们在编程过程中,应使命名名副其实。这件事很重要也很严肃,选个好的名字要花很多时间,但是我们却能省下更多的时间。而且我们一旦发现更好的名字就应换掉旧的。
我们在命名时,名称就应当答复了大多数问题。它应该告诉你,它为什么存在,它做什么事,应该怎么用。

  • 有意义的区分
    我们在命名时应依义命名。万万不能使用数字系列命名(a1,a2 ,···,aN),这样的名称纯属误导——完全没有提供正确信息;没有提供导向作者意图的线索。
  • 使用读得出来的名称
  • 使用可搜索的名称
  • 避免使用编码
  • 避免思维映射
    不应当让读者把你的名称翻译成他们熟知的名称
    -类名
    类名和对象名应该是名词或名词短语
  • 方法名
    方法名应当是动词或动词短语
  • 每个概念对应一个词
    给每个抽象概念选一个词,并且一以贯之。
  • 别用双关语
  • 使用解决方案领域名称
    只有程序员才会读你的代码。所以尽管使用那些计算机科学领域术语、算法名、模式名、数学术语吧。
    -使用源自所涉问题领域的名称
    如果不能用程序员熟悉的术语来命名就采取从所涉问题领域来的名称。
  • 添加有意义的语境
    很少有名称是能自我说明的。所以我们需要用良好命名的类、函数或名名称空间来放置名称,给读者提供语境。如果没有这么做,可以给名称添加前缀。
    注意:不要添加没用的语境,比如给所有类添加同一个前缀。只要语义足够清楚,短名称比长名称要好。
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
【社区内容提示】社区部分内容疑似由AI辅助生成,浏览时请结合常识与多方信息审慎甄别。
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

友情链接更多精彩内容