代码整洁之道-1 如何命名
作者:互联网
在学校的时候,老师们都说要学会为代码加注释,这是一个良好的习惯,注释越多越好。
但是实际并不是这样,对于代码来说,并不是注释越多越好。
当你的代码不得不需要特别多的注释才能让别人看懂,只能说明你的代码不够整洁,不得不用长篇大论来解释自己的代码。
命名很重要,要多花时间去想。
如果想道了更合适的,就多花些时间把原来的替换掉。(不要影响他人使用)
- 需要添加注释来说明的命名就是不够完美的命名:
尽量让自己的命名不加注释也能让别人看懂。 - 不要让名称太过相似:
如果你的项目中同时存在product,productInfo,productData这三个类,一定会让人看着就感觉头大。 - 类名推荐使用名词和名词短语,方法推荐使用动词或动词短语。
- 为每一个抽象概念选一个词,并一以贯之。
- 灵活使用语境:
相同的变量名称放入不同的语境中会表示不同的意思。可以利用这一点减短自己的变量名称,让语境来帮你将变量解释完全。
标签:注释,变量,语境,短语,代码,之道,命名,整洁 来源: https://blog.csdn.net/weixin_44927769/article/details/119327175