hrmai

  博客园 :: 首页 :: 博问 :: 闪存 :: 新随笔 :: 联系 :: 订阅 订阅 :: 管理 ::

2011年5月14日

摘要: 其实没有人问过我为什么不写注释,我也没有向别人说过我不写注释的原因。但是最近一直有人在我耳边说,你们这些鸟人为什么都不写注释了。所以我觉得我有必要做一下解释了。 第一、什么情况下需要注释。如果你面对的受众是一些初学者或者非专业的人员,那么确实需要写注释,这一点在教科书上体现的最多。又或者,你所工作的语言是结构化编程之类的没有很强的层次性(包或者命名空间)和封装(类),那么你需要写注释(C是最好的例子)。最后,如果你写的是算法,或者你的函数中有魔数之类的东西,你需要加注释,比如如果你有一个函数如下,那么你最好写一些注释publicstringGetRequestFile(){if(String. 阅读全文
posted @ 2011-05-14 08:21 Leon Mai 阅读(11999) 评论(194) 推荐(12) 编辑