可读性与命名之道 » 代码简洁性

许多人认为代码的可读性与使用的字母和符号有关。他们相信通过添加、删除或更改这些符号可以使代码更易读。在某种意义上，他们是对的。然而，根本原则是：代码的可读性主要取决于字母和符号如何占用空间。

这意味着什么？嗯，它意味着两件事：

• 代码周围应该有适量的空白。不要太多，也不要太少。
• 一行代码中应该有适当的空间来分隔不同的部分。通常，不同的操作应该放在不同的行上。应该适当使用缩进来分组代码块。

根据这个原则，实际上是代码的缺失使事物可读。这是生活中的一个普遍原则——例如，如果一本书中的字母和单词之间完全没有空格，就很难阅读。另一方面，在晴朗的夜空中很容易看到月亮，因为有很多清晰的黑色空间不是月亮。同样，当你的代码中有适量的空间时，你可以轻松地看出代码的位置和内容。

例如，这段代码很难阅读：

1

x=1+2;y=3+4;z=x+y;print"hello world";print"z is"+z;if(z>y+x){print"error";}

而在行内、周围和行之间有适当的间距时，它变得易于阅读：

1
2
3
4
5
6
7
8

x = 1 + 2;
y = 3 + 4;
z = x + y;
print "hello world";
print "z is" + z;
if (z > y + x) {
    print "error";
}

然而，也可能有太多或错误的空格。这段代码也很难阅读：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

    x            =          1+        2;
y = 3            +4;


  z = x    +      y;
print    "hello world"         ;
 print "z is " + z;
if (z  >     y+x)
 {        print "error" ;
        }

代码本身应该根据其含义的多少来占用空间。

基本上，含义丰富的小符号使代码难以阅读。含义不多的非常长的名称也使代码难以阅读。含义的数量和占用的空间应该密切相关。

例如，这段代码不可读，因为名称太短：

1
2

q = s(j, f, m);
p(q);

这些名称占用的空间非常少，相对于它们的含义来说。然而，使用适当大小的名称，代码块的功能变得更加明显：

1
2

quarterly_total = sum(january, february, march);
print(quarterly_total);

另一方面，如果名称相对于它们所代表的含义来说太长，那么代码又变得难以阅读：

1
2

quarterly_total_for_company_x_in_2011_as_of_today = add_all_of_these_together_and_return_the_result(january_total_amount, february_total_amount, march_total_amount);
send_to_screen_and_dont_wait_for_user_to_respond(quarterly_total_for_company_x_in_2011_as_of_today);

这个原则同样适用于整个代码块，就像适用于单个名称一样。我们可以用单个函数调用替换上面的整个代码块：

1

print_quarterly_total();

这甚至比之前的任何例子都更易读。尽管我们使用的名称——print_quarterly_total——比我们其他的名称长一点，但这没关系，因为它代表了比其他代码片段更多的含义。事实上，它甚至比我们的代码块本身更易读。为什么？因为代码块占用了很多空间，但实际上含义很少，而函数为相同的含义占用了更合理的空间。

如果一个代码块占用了很多空间但实际上没有太多含义，那么它就是一个很好的重构候选。例如，这里有一个处理一些用户输入的代码块：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

x_pressed = false;
y_pressed = false;
if (input == "x") {
    print "You pressed x!";
    x_pressed = true;
}
else if (input == "y") {
    if (not y_pressed) {
        print "You pressed y for the first time!";
        y_pressed = true;
        if (x_pressed) {
            print "You pressed x and then y!";
        }
    }
}

如果那是我们的整个程序，那可能足够可读。然而，如果这在一大堆其他代码中，我们可以像这样使其更可读：

1
2
3
4
5
6
7
8

x_pressed = false;
y_pressed = false;
if (input == "x") {
    handle_x(x_pressed);
}
else if (input == "y") {
    handle_y(x_pressed, y_pressed);
}

我们可以通过将其简化为这样来使其更可读：

1

handle_input(input);

在我们的代码中间阅读“handle_input”比尝试阅读上面的整个第一个块要容易得多，因为“handle_input”占用了正确的空间量，而块占用了太多空间。然而，请注意，如果我们做了类似h(input)的事情，那将会令人困惑和不可读，因为“h”太短，无法正确告诉我们代码在做什么。另外，handle_this_input_and_figure_out_if_it_is_x_or_y_and_then_do_the_right_thing(input)不仅会让程序员输入起来烦人，而且还会导致不可读的代码。

命名事物

一位著名程序员曾说过，命名事物是计算机科学中最难的问题之一。然而，这些可读性原则为我们如何命名事物提供了一些很好的线索。基本上，变量、函数等的名称应该足够长，以完全传达它是什么或做什么，但又不能太长以至于难以阅读。

思考函数或变量将如何被使用也很重要。一旦我们开始将其放入代码行中，它是否会使这些代码行对于它们实际具有的含义来说太长？例如，如果你有一个函数只被调用一次，单独在一行上，该行没有其他代码，那么它可以有一个相当长的名称。然而，一个你将在复杂表达式中频繁使用的函数可能应该有一个短名称（尽管仍然足够长以完全传达它的功能）。

-Max

评论

Ahmed 说：2011年1月25日上午11:21

优秀的“空间编码原则”。我认为这是你即将出版的书中