1 注释泛滥

C++ Gatchas

Avoiding Common Problems in Coding and Design

By Stephen C.Dewhurst

高博 译本（清华大学出版社）译为《C++语言 99个常见编程错误》

陈君 译本（中国青年出版社）译为《C++程序设计陷阱》

第一章 基础问题

1 注释泛滥

在代码容易理解和维护的前提下，尽量减少注释。

尽量让代码“自注释”，方法如下：

（1）遵循简单易行的、定义良好的命名习惯，为实体（函数、类型、变量）取个清晰的、见名知意的名字。函数声明中形参的名字尤为重要。

（2）尽量采用标准库中的或尽为人知的组件。

代码维护时，必须及时维护注释。

2 幻数

幻数指上下文中出现的字面常量，本该是具名常量才对。

带来的问题：

（1）幻数没有名字也就没有语义，不便于阅读。

（2）修改时要逐个修改，不便于维护。

（3）没有体现明确的类型，不同平台上可能有不同的类型，可能降低它的本该需要的精度。

解决方法：使用枚举常量或初始化了的具名常量。在其作用域有着明确含义的枚举常量，不占空间，也没有任何运行期成本。