编写优雅代码的最佳实践
Robert Martin曾说过"在代码阅读中说脏话的频率是衡量代码质量额唯一标准"。同时,代码的写法应当使别人理解它所需的时间最小化,也就是说我们写的代码是给人看的而不是给机器看的。那么,如何编写优雅代码呢?可以从思想层面和具体技巧层面来优化代码,思想层面指的是遵循面向对象设计原则,本期介绍的是具体技巧。
1. 代码总是越短越好吗?
assert((!(bucket = findBucket(key))) || !bucket.isOccupied());
上面这行代码虽然比较短,但是难以阅读。为了更好地阅读,我们做如下修改:
bucket = findBucket(key);
if(bucket != null){
assert(!bucket.isOccupied());
}
减少代码行数是一个好目标,但是让阅读代码的事件最小化是个更好的目标。
2. 给重要语句添加注释
// Fast version of "hash = (65599*hash) + c"
hash = (hash << 6) + (hash << 16) - hash + c
上面这行代码如果没有添加注释,我们根本不知道是什么意思,但是有了这行注释,我们就知道通过移位操作来提升性能。
3. tmp的使用
tmp是我们经常用的,譬如说两个变量置换,都已变成约定俗成了。
tmp = right;
right = left;
left = tmp;
String tmp = user.getName();
tmp += " " + user.getPhoneNumber();
tmp += " " + user.getEmail();
template.set("user_info",tmp);
4.i,j,k,iter,it
:只用做索引或者循环迭代
i,j,k,iter,it
被用做索引或者循环迭代已成为业界规范了(i是index的缩写),例如:
for(int i=0;i<100;i++){
for(int j=0;j<100;j++){
......
}
}
Iterator<String> iter = list.iterator();
while(iter.hasNext()){
......
}
如果我们在其他地方使用i,j,k,那么就会增加阅读者的时间。
5. 附带重要属性
我们把命名当做一种注释的方式,让它承载更多的信息!
![](https://ask.qcloudimg.com/http-save/1576089/f62278ukvc.png?imageView2/0/w/1620)
6. 名字需要多长?
- 在小的作用域中使用简短的名字
- 在作用域大的可以使用长名字
if(debug){
Map<String,Integer> m = new HashMap<>();
lookUpNamesNumbers(m);
print(m);
}
7. 不要使用容易误解的名字
results = Database.all_objects.filter("year<=2011")
上面这行代码结果现在包含哪些信息?filter是把年份小于等于2011年的数据过滤掉?还是保留?
8. 推荐用min和max来表示极限
MAX_ITEMS_IN_CART = 10;
if (shoppingCart.numOfItems()> MAX_ITEMS_IN_CART){
error("Too many items in cart");
}
9. 推荐用begin和end来表示包含/排除范围
![](https://ask.qcloudimg.com/http-save/1576089/15qd5x5x9y.png?imageView2/0/w/1620)
begin表示包含,end表示排除,在Java中典型的例子就是String.substring()
String s = "Hello world";
s.substring(2,5);-> "llo"
10.与使用者的期望相匹配
一般来说,getter方法就是获取一个字段的值,用户期待的是轻量级的方法,如果你要是在其中做了太多的计算,就应该考虑改名。
public double getMeanPrice(){
//遍历所有条目计算总价,然后计算平均价格
}
public double computeMeanPrice(){
//遍历所有条目计算总价,然后计算平均价格
}
11.不要为那些从代码本身就能快速推断的事实写注释
public class Account {
// Constructor
public Account(){
...
}
// Set the profit member to a new value
void setProfit(double profit){
...
}
// Return the profit from this Account
double getProfit(){
...
}
};
12. 不要给不好的名字加注释--应该把名字改好
// Releases the handle for this key.This doesn't modify the actual registry.
void deleteRegistry(RegistryKey key)
乍一看我们会误认为这是一个删除注册表的函数,可是注释里澄清它不就改动真正的注册表。因此,我们可以用一个更加自我说明的名字,例如:
void releaseRegistryHandle(registryKey key);
13.为代码中的瑕疵写注释
// TODO:采用更快算法或者当代码没有完成时 // TODO(dustin):处理除JPEG以外的图像格式
![](https://ask.qcloudimg.com/http-save/1576089/qwlx9fpl1n.png?imageView2/0/w/1620)
14.为常量写注释
// users thought 0.72 gave the best size/quality tradeoff
image_quality = 0.72;
// as long as it's >= 2*num_processors,that's good enough
NUM_THREADS = 8;
// impose a reasonable limit - no human can read that much anywhere
const int MAX_RSS_SUBSCRIPTIONS = 1000;
15. 站在读者的角度写注释
struct Recoder {
vector<float> data;
...
void clear(){
// 每个人读到这里都会问,为啥不直接调用data.clear()
vector<float>().swap(data);
}
}
如果有一个好的注释可以解答读者的疑问,将上述进行如下修改:强制Vector真正地把内存归还给内存分配器,详情请查阅STL swap trick。
16. 公布可能的陷阱
void sendMail(String to,String subject,String body);
这个函数由于需要调用外部服务器发送邮件,可能会很耗时,有可能导致使用者的线程挂起。需要将这段描述放到注释中。
17. 条件语句中参数的顺序
![](https://ask.qcloudimg.com/http-save/1576089/8vsfe553ua.png?imageView2/0/w/1620)
一般原则:将变量放在左边,常量放在右边。更宽泛地说,将比较稳定的变量放在右边,变化较大的放在左边。如 if ( length >= 10) 而不是 if ( 10 <= length)。但是,在非“大小”比较的情况下,上面的原则似乎不起作用,例如验证一个请求参数是否为某个特定值:if ( request.getParameterValue("name")).equals("Brandon"))
,此时将常量"Brandon"可以避免出现空指针的情况(上行的参数没有name或者值为空)。
18. if/else语句块的顺序
if/else书写规范:首先处理正逻辑而不是负逻辑,例如 if(ok),而不是if(!ok);其次处理掉简单的情况,这有利于让if和else处理代码在同一个屏幕内可见。
19. 通过提早返回减少嵌套
使用提前返回的机制,可以把函数的嵌套层级变浅。举个栗子,没有使用提前返回的代码:
static bool checkUserAuthority()
{
bool a, b, c, d, e;
if (a)
{
if (b)
{
if (c)
{
if (d)
{
if (e)
{
return true;
}
}
}
}
}
return false;
}
使用了提前返回的代码:
static bool checkUserAuthority()
{
bool a, b, c, d, e;
if (!a)
return false;
if (!b)
return false;
if (!c)
return false;
if (!d)
return false;
if (!e)
return false;
return true;
}
20. 通过 "总结变量" 增加可读性
if(request.user.id == document.owner_id){
// user can edit this document ...
}
if(request.user.id != document.owner_id){
// document is read-only...
}
通过观察,我们提取一个变量final boolean user_owns_document=(request.user.id == document.owner_id)
,接着代码就可以修改成:
if(user_owns_document){
// user can edit this document ...
}
if(!user_owns_document){
// document is read-only...
}
21. 减少控制流变量
在while、for等循环语句中,我们通常使用自定义的bool变量,来控制流转。
boolean done = false;
while(/* condition */ && !done){
...
if(...){
done = true;
continue;
}
}
以我们的经验,"控制流变量" 可以通过优化程序结构、逻辑来消除。
while(/* condition */){
...
if(...){
break;
}
}
22. 缩小变量的作用域
void foo(){
int i = 7;
if(someCondition){
// i is used only within this block
}
}
void foo(){
if(someCondition){
int i = 7;
// i is used only within this block
}
}
23. 不要为了共享而把变量设置为类的字段
public class LargeClass{
String s;
void method1(){
s = ...
method2();
}
void method2(){
//使用s
}
}
通过参数传递来实现数据共享
public class LargeClass{
void method1(){
String s = ...
method2(s);
}
void method2(String s){
//使用s
}
}
24. 不要把所有变量都定义在开头
把所有变量定义在开头是C语言的风格,面向对象语言习惯将变量定义在离它开始使用的地方。
public void foo(){
boolean debug = false;
String[] pvs;
String pn;
String pv;
...
}
除了上述建议之外,我们还可以参考阿里Java规范,关注微信号:"木可大大",发送"阿里Java规范"即可获得相关资料。