结对同组同学贾雅杰:http://www.cnblogs.com/jyj5951/

参见教材第68页至第78页,2人结对编写《代码规范》,并在本周作业中遵循。

要求1 《代码规范》包括10项条款。制定条款的目的是在程序设计的过程中(触犯和)约束代码风格,希望切实可行,容易观察和客观检验。

初始版本(后发生增强的条款用蓝色标明,削弱的用绿色,废除的用红色):

  1. 为方便维护,必须对每个函数都添加文档注释
  2. 大括号独占一行并上下对齐(添加规范11)
  3. 函数采用大驼峰法命名
  4. 变量采用小驼峰法命名(添加规范12)
  5. 不要把多个变量定义在一行
  6. 单个函数不可超过50行
  7. 关键语句需加注释
  8. 单行注释在代码上方
  9. 要清多余导入的包及僵尸代码
  10. 魔鬼数字必须以变量方式进行调用,不可直接使用
  11. 为了便于单步调试,需要有断行
  12. 变量名需要有意义

要求2 记录完成本周作业过程中,《代码风格规范》执行情况。包括记录每一条规则的违反和纠正、次数,规范中某项条款的增强、消弱、或废除。在编码过程中完全未被违反的条款,说明过于宽松,或你们已经完全"本能"反应,不应作为条款,在本要求及要求1中不得分。此种情况,应补充一条新的条款。 (20分)

记录如下,博客中对其中不好理解的部分添加了截图解释。

第一条:违反次数2 纠正2次 

  后来将规范增强为文档注释需要表明用途,形参,返回值等详细信息,如下图所示

  

第二条:违反次数0次,因为visual studio编辑器会自动格式化生成,将其废除,并改为“为了便于单步调试,需要有断行”该项违反1次,纠正一次如下图

  

第三条:违反次数6次,纠正六次

第四条:违反0次,故而废除,因为与两人编码习惯皆符合,所以新增条款“变量名需要有意义”

第五条:违反2次,纠正2次

第六条:违反1次,但是因为违规代码已经为精简版本,再减少会影响代码质量,并未纠正,将规则减弱为代码不超过55行(违规代码为52行)违规代码截图

  

第七条:违反次数7次,纠正2次

第八条:违反4次,纠正4次(每次违反均是因为将注释加在了代码右侧)

第九条:违反17次,纠正2次(这个是在代码完成后统计的,7次是每个多余的包的个数和多余函数的总和,分两次统计,每次统计后一起进行纠正,如下图)

 

第十条:违反2次,纠正1次

改正:

第十一条:违反4次,纠正一次

 第十二条:违反1次,纠正1次

 

posted on 2017-10-09 21:08  clairewyd  阅读(272)  评论(0编辑  收藏  举报