cleanCode-有意义的命名

    代码当中充满了命名,方法、函数、类或者接口。命名是代码表达力的重要组成部分。没有好的命名,代码整洁也无从谈起。
下面谈一谈关于命名的那些事。
    不同实体(类、方法等)之间的命名规则略有不同,此外大同小异。他们有一个最共同的目的,就是要有表达力,让代码更清晰。遵循如下几条规则,就能事半功倍。
    1.命名要足够的细节,能够完全描述被命名的实体的实际作用。不要使用注释去进行额外的解释。
    2.使用对象来管理数据总是最合适的。
    3.命名务必要准确,如果代码发生了变化,一定要及时更新,也不要因为含糊不清而让其他人去猜测变量的作用。
    4.命名要有区分度,而且是有意义的区分,尤其是在一些特殊的情况下。尽量不要包含没有任何信息的短语,比如data、info。
    5.命名要便于交流讨论,尽量避免过度简写,但也不能因此造成过长的命名,需要权衡。
    6.命名不宜太短,随着作用域的扩大,过短的命名会导致搜索起来比较麻烦。
    7.类名或对象名应该是名词或名词短语,方法名应该是动词或动词短语。考虑到构造函数名称强制与类名相同,可以使用静态工厂模式去创建对象。
    8.不要为在不同位置的同一个抽象概念选择不同的名称,即使这些名称含义近似。也不要为不同的抽象概念选择同一个名称。尽量做到一词一义。
    9.名称往往很难自我说明,一个单独的名称想要自我说明通常需要在名称中加入超长的状语和定语。但变量名,类名和方法名往往不是独立存在的,通过这些实体之间的关系,我们可以知道名称的背景,从而获取这个名称所代表的真正含义。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值