Wetts's blog

Stay Hungry, Stay Foolish.

0%

代码整洁之道-第4章-注释

注释不能美化糟糕的代码

带有少量注释的整洁而有表达力的代码,要比带有大量注释的零碎而复杂的代码像样得多。

用代码来阐述

1
if ((employee.flags & HOURLY_FLAG) && (employee.age > 65))

or

1
if (employee.isEligibleForFullBenefites())

只要想上那么几秒钟,就能用代码解释你大部分的意图。很多时候,简单到只需要创建一个描述与注释所言同一事物的函数即可。