当我们将信息装进名字里,不免会导致一个问题的出现-那是该名字是否让其他人产生歧义或者误解,所以我们应该主动发现所谓的误解点并修正更改
例如避免使用filter(不知道是挑选(可以使用choose)还是过滤(screen_out))和clip(不知道是从尾部还是哪里剪切掉)等二义词
当用到极限或者边缘性范围的,不要使用limit这样的歧义词,推荐使用min/max(【包含】极限),first/last(【包含】范围),begin/end(【包含/排除】范围)这些解释性词义作为前缀进行解释
对于一些先入为主的歧义词我们应该与使用者的期望相匹配,比如:get*()方法习惯上试作为一种轻量级访问器的使用,它只是简单返回一个内部成员的变量,如果像getMean()是实现遍历所有数据且加以计算中值,可能导致其他人随意误用付出一定的代价
代码结构上的审美性有三大原则:第一,使用一致的布局风格;第二,让相似的代码看上相似;第三,把相关的代码行分组,形成代码块。
具体的技巧:1如果多个代码块做相似的事情,尝试让他们有相同的剪影;2把代码按“列”对齐可以使代码更容易浏览;3如果在一段代码上提到A,B和C,在另一段上也使用相同顺序,即选择一个有意义的顺序,并始终使用下去;4用空行将代码块按逻辑分成“段落” |