编写可读代码的艺术(三)不要起误解的名字以及代码上的‘审美’

论坛 期权论坛 脚本     
已经匿名di用户   2022-7-2 22:16   5705   0

当我们将信息装进名字里,不免会导致一个问题的出现-那是该名字是否让其他人产生歧义或者误解,所以我们应该主动发现所谓的误解点并修正更改

例如避免使用filter(不知道是挑选(可以使用choose)还是过滤(screen_out))和clip(不知道是从尾部还是哪里剪切掉)等二义词

当用到极限或者边缘性范围的,不要使用limit这样的歧义词,推荐使用min/max(【包含】极限),first/last(【包含】范围),begin/end(【包含/排除】范围)这些解释性词义作为前缀进行解释

对于一些先入为主的歧义词我们应该与使用者的期望相匹配,比如:get*()方法习惯上试作为一种轻量级访问器的使用,它只是简单返回一个内部成员的变量,如果像getMean()是实现遍历所有数据且加以计算中值,可能导致其他人随意误用付出一定的代价

代码结构上的审美性有三大原则:第一,使用一致的布局风格;第二,让相似的代码看上相似;第三,把相关的代码行分组,形成代码块。

具体的技巧:1如果多个代码块做相似的事情,尝试让他们有相同的剪影;2把代码按“列”对齐可以使代码更容易浏览;3如果在一段代码上提到A,B和C,在另一段上也使用相同顺序,即选择一个有意义的顺序,并始终使用下去;4用空行将代码块按逻辑分成“段落”

分享到 :
0 人收藏
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

积分:81
帖子:4969
精华:0
期权论坛 期权论坛
发布
内容

下载期权论坛手机APP