Linux 内核代码风格
——fanfannothing
这是一个简短的文档,描述了 linux 内核的首选代码风格。代码风格是因人而异的,而且我不愿意把我的观点强加给任
何人,不过这里所讲述的是我必须要维护的代码所遵守的风格,并且我也希望绝大多数其他代码也能遵守这个风格。请在写
代码时至少考虑一下本文所述的风格。
首先,我建议你打印一份 GNU 代码规范,然后不要读它。烧了它,这是一个意义重大的象征性的动作。不管怎样,现
在我们开始:
第一章:缩进
制表符是 8 个字符,所以缩进也是 8 个字符。有些异端运动试图将缩进变为 4(乃至 2)个字符深,这几乎相当于尝
试将圆周率的值定义为 3。
理由:缩进的全部意义就在于清楚的定义一个控制块起止于何处。尤其是当你盯着你的屏幕连续看了 20 小时之后,你
将会发现大一点的缩进将会使你更容易分辨缩进。
现在,有些人会抱怨 8 个字符的缩进会使代码向右边移动的太远,在 80 个字符的终端屏幕上就很难读这样的代码。这
个问题的答案是,如果你需要 3 级以上的缩进,不管用何种方式你的代码已经有问题了,应该修正你的程序。
简而言之,8 个字符的缩进可以让代码更容易阅读,还有一个好处是当你的函数嵌套太深的时候可以给你警告。留心
这个警告。
在 switch 语句中消除多级缩进的首选的方式是让“switch”和从属于它的“case”标签对齐于同 一列,而不要“两
次缩进”“case”标签。比如:
switch (suffix) {
case 'G':
case 'g':
mem <<= 30;
break;
case 'M':
case 'm':
mem <<= 20;
break;
case 'K':
case 'k':
mem <<= 10;
/* fall through */
default:
break;
}
不要把多个语句放在一行里,除非你有什么东西要隐藏:
if (condition) do_this;
do_something_everytime;
也不要在一行里放多个赋值语句。内核代码风格超级简单。就是避免可能误导别人的表达式。
除了注释、文档和 Kconfig 之外,不要使用空格来缩进,前面的例子是例外,是有意为之。
选用一个好的编辑器,不要在行尾留空格。
第二章:把长的行和字符串打散
代码风格的意义就在于使用平常使用的工具来维持代码的可读性和可维护性。每一行的长度的限制是 80 列,我 们 强 烈