《2017-12-01构建之法：现代软件工程-阅读笔记》

Posted 2020-10-16 刘铭阿

1.代码规范可以分为两个部分：

（1）代码风格规范。主要是文字上的规定，看似表面文章，实际上非常重要。

（2）代码设计规范。牵涉到程序设计、模块之间的关系、设计模式等方方面面的功用原则。

1.1 代码设计风格：
（1）缩进

（2）行宽

（3）括号

（4）断行与空白的{}行

（5）分行

（6）命名

（7）下划线

（8）大小写

（9）注释

1.2代码设计规范：

（1）函数

（2）goto

（3）错误处理

　　a.参数处理

　　b.断言

2.代码复审：看代码是否在“代码规范”的框架内正确地解决了问题。

　　2.1代码复审的形式

　　　　自我复审

　　　　同伴复审

　　　　团队复审

　　软件工程中最基本的复审手段，就是同伴复审。

　　2.2代码复审的目的：

　　a 找出代码的错误

　　　　编码错误

　　　　不符合团队代码规范的地方

　　b 发现逻辑错误

　　c 发现算法错误

　　d 发现潜在的错误和回归性错误

　　e 发现可能需要改进的地方

　　f 教育（互相教育）开发人员，传授经验，让更多的成员熟悉项目各个部分的代码，同时熟悉和应用领域相关的实际知识。

3.传统意义上的伙伴复审，即程序员之间的互相复审，有以下的问题：

　　1）复审人缺乏对程序的深入了解，减弱了复审的效果；　　

　　2）不能持久、定时地进行复审；

　　3）对需求和设计的不了解导致无法实现全面有效的复审；

4.团队复审是指多于两人 的团队就某一程序实体进行的复审，团队复审的缺点在于：

　　1）什么时候开会做复审？不可能一个团队天天开会。要找到一个所有人都能出席的时间，并不容易；

　　2）牵涉的人员太多，理解程度不一，复审的速度和效果不能得到有效的平衡——太快则有人不懂，太慢则浪费许多人的时间；

　　3）正是由于成本问题，无法对所有的设计和代码进行深入的复审；

　　4）由于人员众多，有面子问题