其他分享
首页 > 其他分享> > 代码整洁之道-1 如何命名

代码整洁之道-1 如何命名

作者:互联网

在学校的时候,老师们都说要学会为代码加注释,这是一个良好的习惯,注释越多越好。
但是实际并不是这样,对于代码来说,并不是注释越多越好。
当你的代码不得不需要特别多的注释才能让别人看懂,只能说明你的代码不够整洁,不得不用长篇大论来解释自己的代码。

命名很重要,要多花时间去想。

如果想道了更合适的,就多花些时间把原来的替换掉。(不要影响他人使用)

  1. 需要添加注释来说明的命名就是不够完美的命名
    尽量让自己的命名不加注释也能让别人看懂。
  2. 不要让名称太过相似:
    如果你的项目中同时存在product,productInfo,productData这三个类,一定会让人看着就感觉头大。
  3. 类名推荐使用名词和名词短语,方法推荐使用动词或动词短语。
  4. 为每一个抽象概念选一个词,并一以贯之。
  5. 灵活使用语境:
    相同的变量名称放入不同的语境中会表示不同的意思。可以利用这一点减短自己的变量名称,让语境来帮你将变量解释完全。

标签:注释,变量,语境,短语,代码,之道,命名,整洁
来源: https://blog.csdn.net/weixin_44927769/article/details/119327175