编码审查表

来自《write clean code》
编码审查表：

一般问题
── 你是否为程序建立了DEBUG版本？
── 你是否将发现的错误及时改正了？
─一 你是否坚持彻底测试代码．即使耽误了进度也在所不惜？
── 你是否依靠测试组为你测试代码？
─一 你是否知道编码的优先顺序？
─一 你的编译程序是否有可选的各种警告？

关于将更改归并到主程序
─一 你是否将编译程序的警告（包括可选的）都处理了？
── 你的代码是否未用Lint
─一 你的代码进行了单元测试吗？
─一 你是否逐步通过了每一条编码路径以观察数据流？
─一 你是否逐步通过了汇编语言层次上的所有关键代码？
── 是否清理过了任何代码？如果是，修改处经过彻底测试了吗？
─一 文档是否指出了使用你的代码有危险之处？
── 程序维护人员是否能够理解你的代码？
 
每当实现了一个函数或子系统之时
─一 是否用断言证实了函数参数的有效性？
─一 代码中是否有未定义的或者无意义的代码？
─一 代码能否创建未定义的数据？
─一 有没有难以理解的断言？对它们作解释了没有？
─一 你在代码中是否作过任何假设？
─一 是否使用断言警告可能出现的非常情况？
─一 是否作过防御性程序设计？代码是否隐藏了错误？
─一 是否用第二个算法来验证第一个算法？
─一 是否有可用于确认代码或数据的启动（startup）检查?
─一 代码是否包含了随机行为？能消除这些行为吗？
── 你的代码若产生了无用信息，你是否在DEBUG代码中也把它们置为无用信息？
── 代码中是否有稀奇古怪的行为？
── 若代码是子系统的一部分，那么你是否建立了一个子系统测试？
── 在你的设计和代码中是否有任意情况？
── 即使程序员不感到需要，你也作完整性检查吗？
── 你是否因为排错程序太大或太慢，而将有价值的DEBUG测试抛置一边？
── 是否使用了不可移植的数据类型？
─一 代码中是否有变量或表达式产生上溢或下溢？
── 是否准确地实现了你的设计？还是非常近似地实现了你的设计？
── 代码是否不止一次地解同一个问题？
── 是否企图消除代码中的每一个if语句？
── 是否用过嵌套？：运算符？
── 是否已将专用代码孤立出来？
── 是否用到了有风险的语言惯用语？
─一 是否不必要地将不同类型的运算符混用？
── 是否调用了返回错误的函数？你能消除这种调用吗？
─一 是否引用了尚未分配的存储空间？
─一 是否引用已经释放了的存储空间？
── 是否不必要地多用了输出缓冲存储？
── 是否向静态或全局缓冲区传送了数据？
── 你的函数是否依赖于另一个函数的内部细节？
── 是否使用了怪异的或有疑问的C惯用语？
── 在代码中是否有挤在一行的毛病？
── 代码有不必要的灵活性吗？你能消除它们吗？
─一 你的代码是经过多次“试着”求解的结果吗？
─一 函数是否小并容易测试？
 
每当设计了一个函数或子系统后
─一 此特征是否符合产品的市场策略？
─一 错误代码是否作为正常返回值的特殊情况而隐藏起来？
─一 是否评审了你的界面，它能保证难于出现误操作吗？
─一 是否具有多用途且面面俱到的函数？
─一 你是否有太灵活的（空空洞洞的）函数参数？
─一 当你的函数不再需要时，它是否返回一个错误条件？
─一 在调用点你的函数是出易读？
─一 你的函数是否有布尔量输入？
 
修改错误之时

── 错误无法消失，是否能找到错误的根源？
─一 是修改了错误的真正根源，还是仅仅修改了错误的症状？