代码应该足够清晰以至能够自我描述,能够清楚表达做什么以及怎么做,但是代码往往无法表达为什么这样做。因为受环境影响,代码所体现的设计不一定是最优的方式。写满注释的代码与没有注释的代码一样糟糕,因为阅读代码的难点在于理清代码的作用与意图,而阅读注释的难点在于代码和描述代码的注释之间存在着语义距离,这种语义距离导致读者迷惑和误解。
常听到要多写注释观点,的确存在这种情况,就是团队开发中各人的编程能力参差不齐,对代码的理解能力差异很大,为了迁就大部分成员,应该多写注释。但试问一下:是应该降低标准来适应自身还是应该以高标准来促使自身不断改进?我们的精力是不是被放错了地方?
欢迎大家发表意见。