1. 实现一个函数只是为了做好一件事情,不要把函数设计成用途广泛、面面俱到的,这样的函数肯定会超长,而且往往不可重用,维护困难。

    2. 函数不要写得太长,建议在24行的标准终端上不超过两屏,太长会造成阅读困难,如果一个函数超过两屏就应该考虑分割函数了。中特别说明,如果一个函数在概念上是简单的,只是长度很长,这倒没关系。例如函数由一个大的组成,其中有非常多的case,这是可以的,因为各分支互不影响,整个函数的复杂度只等于其中一个case的复杂度,这种情况很常见,例如TCP协议的状态机实现。

    3. 比较重要的函数定义上侧必须加注释,说明此函数的功能、参数、返回值、错误码等。