什么样的代码才能被称为好的代码

2012/6/13 11:47:00  请友读忠(更多)  E界MRP开发下载网  528阅

  “好的代码”应能工作,应当没有错误,具有可读性和可维护性。有的机构有代码“标准”,供所有的开发人员遵循,但每个人对于“什么是最好的”以及“规则太多或太少”有着不同的看法。理论和方法也很多,例如马克开伯复杂计算法 (McCabe Complexity metrics) 就是一种。这种方法使人过分考虑标准和规则,从而限制了产量和创造性。“同事互检”( Peer reviews) 和“伙伴检察”(buddy checks) 中使用的代码分析等工具可以被用于检察错误和执行标准。
 
  对于 C 和 C++ 代码,在建立规则/标准时,这里有一些典型的思路。但不一定适用于一切情况:
 
   减少或排除全局变量的使用。
 
   使用说明性的函数和方法名 —— 使用大、小写字符,避免用缩写,使用满足要求的说明文字来进行充分的描述 (使用超过 20 个字符也不致超行)。取名要与功能一致。
 
   使用说明性的变量名 —— 使用大、小写字符,避免用缩写,使用满足要求的说明文字来进行充分的描述 (使用超过 20 个字符也不致超行)。取名要与功能一致。
 
   函数和方法的大小要尽可能小 —— 最好不超过 100 行,少于 50 行最好。
 
   在函数代码前面的函数的说明文字应当清楚。
 
   书写代码应便于阅读。
 
   在水平方向和垂直方向都留出足够的空间
 
   每行代码字符数不超过 70 个
 
   每条语句占 1 行
 
   一个程序内的代码风格应一致 (在使用括弧、缩排、和命名方式等方面)
 
   注释内容宁多勿少,通常注释行的数量 (包括开始部分) 应当不少于代码行的数量
 
   不管应用程序多么小,都应有文档,包括程序功能的概述和流程图 (哪怕只有几行字,也比没有要好)。如果可能的话,最好有单独的流程图和详细的程序文档。
 
   尽最大可能使用错误处理过程,并对状况和错误进行记录。
 
   在使用 C++ 时,为了减少复杂程度和提高可维护性,应当避免类的继承的层数过多 (这取决于应用程序的大小和复杂程度)。除要尽量减少继承的层次以外,还应少用超负荷运算符 (minimize use of operator overloading)。使用 Java 语言可以消除多级继承和运算符超负荷。
 
   在使用 C++ 时,保持类的方法不要太大,对于每各类的方法,代码行不超过 50 行为最佳。
 
   在使用 C++ 时,应自由进行例外的处理 (make liberal use of exception h*lers)
 
分享至:
good 32

发表评论

文明评论,重在参与

暂无评论!
返回上级 返回首页
首页合作客服留言QQ群简版
E界,引领视界
mrpej.com @CopyRight