主　　题：我的毛病，也是很多程序员的通病
作　　者：nieyongxin
所属论坛：Visual C++
问题点数：50
回复次数：18
发表时间：2000-8-16 8:41:00
我没有受过正规有效的编程教育，一切都是自己摸索着学习编程的，相信从计算机专业出来的也一样，我编程时编码很不规范，我自己的程序别人看懂很费劲，请问各大高手，有没有编码规范方面的资料和电子书籍！


回复贴子：
回复人：Wingsun(2000-8-16 8:45:00) 得0分
你应该去看一些软件工程的书，在书店中有。
回复人：Areslee(2000-8-16 8:46:00) 得0分
看一看软件工程方面的书就可以了
回复人：Ray_czh(2000-8-16 8:48:00) 得0分
      我想编程不规范的原因是由于你没有做好详细的需求分析，就开始动手做程序了。对于大的软件项目是一定要作好需求分析，才能开始编写软件的，否则后期的维护工作是很难进行的。
      另外对与在写程序的过程中，良好的编程风格比编程技巧更加重要。要记住看程序的不会是你自己一个人。
回复人：VictorYu(2000-8-16 9:32:00) 得0分
我也一样,多看源码
www.codeguru.com
回复人：Jackzhu(2000-8-16 10:08:00) 得0分
程序编写规范


--------------------------------------------------------------------------------

    在软件编程过程中，如果每个程序员都按自己的习惯和风格编写程序，这种因人而异的程序风格势必降低程序的可读性，对软件的测试、交流、重用以及软件的维护产生极为不利的影响。为了解决这个问题，最终提高开发效率，必须执行本规范。

    本规范在编程基本风格、可读性、结构化、正确性与容错性、可重用性等方面提出了要求，它是程序员编程素质的综合体现。程序员的编程水平＝编程规范＋编程效率。

1.基本要求

1.1程序结构清析，简单易懂，单个函数的程序行数不得超过100行。

1.2打算干什么，要简单，直接了当，代码精简，避免垃圾程序。

1.3尽量使用标准库函数和公共函数。

1.4不要随意定义全局变量，尽量使用局部变量。

1.5使用括号以避免二义性。

　

2.可读性要求

2.1可读性第一，效率第二。

2.2保持注释与代码完全一致。

2.3每个源程序文件，都有文件头说明，说明规格见规范。

2.4每个函数，都有函数头说明，说明规格见规范。

2.5主要变量（结构、联合、类或对象）定义或引用时，注释能反映其含义。

2.7常量定义（DEFINE）有相应说明。

2.8处理过程的每个阶段都有相关注释说明。

2.9在典型算法前都有注释。

2.10利用缩进来显示程序的逻辑结构，缩进量一致并以Tab键为单位，定义Tab为 6个字节。

2.11循环、分支层次不要超过五层。

2.12注释可以与语句在同一行，也可以在上行。

2.13空行和空白字符也是一种特殊注释。

2.14一目了然的语句不加注释。

2.15注释的作用范围可以为：定义、引用、条件分支以及一段代码。

2.16注释行数（不包括程序头和函数头说明部分）应占总行数的 1/5 到 1/3 。

　

3.结构化要求

3.1禁止出现两条等价的支路。

3.2禁止GOTO语句。

3.3用 IF 语句来强调只执行两组语句中的一组。禁止 ELSE GOTO 和 ELSE RETURN。

3.4用 CASE 实现多路分支。

3.5避免从循环引出多个出口。

3.6函数只有一个出口。

3.7不使用条件赋值语句。

3.8避免不必要的分支。

3.9不要轻易用条件分支去替换逻辑表达式。

　

4.正确性与容错性要求

4.1程序首先是正确，其次是优美

4.2无法证明你的程序没有错误，因此在编写完一段程序后，应先回头检查。

4.3改一个错误时可能产生新的错误，因此在修改前首先考虑对其它程序的影响。

4.4所有变量在调用前必须被初始化。

4.5对所有的用户输入，必须进行合法性检查。

4.6不要比较浮点数的相等，

如： 10.0 * 0.1 == 1.0 ， 不可靠

4.7程序与环境或状态发生关系时，必须主动去处理发生的意外事件，如文件能否逻辑锁定、打印机是否联机等。

4.8单元测试也是编程的一部分，提交联调测试的程序必须通过单元测试。

　

5.可重用性要求

5.1重复使用的完成相对独立功能的算法或代码应抽象为公共控件或类。

5.2公共控件或类应考虑OO思想，减少外界联系，考虑独立性或封装性。

5.3公共控件或类应建立使用模板。
回复人：magicwizard(2000-8-16 10:51:00) 得0分
关于规范的电子书籍我到是没见过,不过编程书中都会零散的说一些,你可以下载别人的源代码,或看随书所附光盘中的代码,你就能找到答案的.你用VC写程序吧!它的编辑器很好用的呦!
回复人：onion(2000-8-16 20:41:00) 得0分
就和做作业一样，这也是个习惯，要在平时养成。专门的书没有，倒是一本南开的WINDOWS编程的书上有这方面的说明，较详细。
回复人：DUKE_SOFT(2000-8-17 4:37:00) 得0分
Give you a website, maybe you'll find it's useful.
http://www.umr.edu/~cpp/
Just like Onion said, it's like to do homework. Use them, your programs will be better.