代码规范:换行对齐问题

来源:互联网 发布:淘宝开店不用交保证金 编辑:程序博客网 时间:2024/05/02 00:45
今天有同事看了我写的代码,问为何逗号要放在前面,以下列两段代码为列:


代码段一
void function(int a
                  , char b
                  , short c
                  , long d
                  , struct* e)
{
}
注:这里的排版有点问题,实际应当是int和char等对齐的。

代码段二:
int x = a
       + b
       + c
       + d;


对一于单行代码过长时,采取换行,这个没有什么可争议的,主要焦点在新的一行从哪开始,通常有两派,一派就是如上述两段代码所示,另一派则采用如下规范:
void function(int a,
                    char b,
                    short c,
                    long d,
                    struct* e)
{
}


在刚出道的前几年,我采用的是逗号置尾风格,但后来,我一直采用逗号置前的风格,因为我认为这样做更好,为什么会更好了?先提一个问题:换行的目的是什么?我想答案应当是:让代码更清晰,可读性更好,也让书写更不容易犯错误。总结起来有以下几条好处:
1.代码更清晰(这条不是独特的,因为逗号置尾也一样具备)
2.逗号有类似于1、2、3的标识作用,如同在写WORD或PPT文档时列出一、二、三、四
3.有注释的作用,可以将逗号看成注释符,可以更清楚的标明这是一行的开始
4.可增加代码的观赏性,统一以逗号打头,显得更有美感


有些时候,简单换行仍可能导致单行过长,这个时候可改变对齐点,我一般如下做:
void function(
      int a
    , char b,
    , short c,
    , long d,
    , struct* e)
{
}


这样基本可以解决大多数参数列表过长问题,对于表达式过长的问题,采取同样的解决方式。


我们需要规范,但不应当是死板的规范,最好可让它展现出一点活力,比如对于二目操作符的空格问题,就应当有柔性,而不是不分场合统一前后空一格,如:
int x = (a + b) / M;
虽然很规范,但从美观上来说,不协调,如同一个人身材虽棒,但却如水桶,也许下面的做法更好:
int x = (a+b) / M;
让a和b更紧凑点,整体上看起来就协调多了。还有一些类似的,比如不要头重脚轻,象:
if (false)
{
    int m = x[i];
    int d = foo(m);
    woo(d);
}
else
{
    ++i;
}
这个就长了个大脑袋,很多小孩子就是这样,头大大的,颠倒过来成人:
if (true)
{
    ++i;
}
else
{
    int m = x[i];
    int d = foo(m);
    woo(d);
}
现在就符合我们日常的审美了。细节不一定决定成败,但一定影响品质,电路板就是一个好的见证。开源项目mooon在遵循规范的同时,也一直在努力提升代码的美感。
原创粉丝点击