关于代码的注释

limboy's HQ at 
怎样的注释才是合理的?关于这个问题,首先要回答的问题是:为什么要注释?注释通常是为了方便其他程序员阅读源码,让他能够明白这个变量是做什么用的,这段代码是为了完成什么任务等等,不至于三更半夜系统出现了 bug,结果在程序里翻山越岭,跋山涉水,还没有找到出问题的代码,好不容易找到了,又不知道如何修改。那是不是注释越多越详细越好呢?也不是。因为程序是会经常变动的,这加个参数,那改个变量是很正常的,稍不注意就会忘了更新注释。而且从程序员的角度来说,也不愿去更新注释,一个是因为懒,另一个是因为知道将来还可能会变,索性等将来再说。以后维护该程序的人,看着注释和程序就会很纠结。所以不愿写注释是程序员的天性,……