注释简单代码会干扰对重要注释的理解。程序开发者最好能用最精要的注释来解释重点代码。 举个例子,你打开一个电箱,里面有几百根电线,蒙了吧。再一看,每根电线上面都有一个整洁的小标签。真是谢天谢地啊!但是,当你一个个去翻看标签的时候,见鬼的,几乎所有的标签都是空白的! 然后,在你花了整整一个小时去浏览每一个小标签之后,终于给你找到12条有用的信息,真心喜大普奔!当然,希望在你头脑一片混乱的时候得出的结果仍然是正确的,没有遗漏,呵呵呵。 当我需要研究代码的时候看到到处都是垃圾注释,唉,我的感觉就和上面在那
2014-12-16 13:58
下面是stackoverflow网站上网友针对你看到过的最好的代码注释是什么样的? 这个问题给出的回答的前10条: // 亲爱的维护者: // 如果你尝试了对这段程序进行优化, // 并认识到这种企图是大错特错,请增加 // 下面这个计数器的个数,用来对后来人进行警告: // 浪费在这里的总时间 = 39h /** * 致终于来到这里的勇敢的人: 你是被上帝选中的人,英勇的、不辞劳苦的、不眠不修的来修改 我们这最棘手的代码的编程骑士。你,我们的救世主,人中之龙, 我要对你说:永远不要放弃,永远不要对自己失望,永远不要逃走,辜负了自己。 永远不要哭
2014-09-12 08:08
与其说是代码的实际逻辑,还不如说是开发人员自己添加到代码中的注释,对代码产生了颇为深远的影响。这篇文章的主题就是罗列一些我印象深刻的一些代码注释。
2016-02-17 15:51 John Vester, 小峰
你有没有这样的经历:别人审查过你的代码之后给出的注释,你认为是没有必要的?注释代码是为了提高代码的可读性,目的是为了能让其他人更容易理解你的代码。 我特别讨厌这5种注释类型以及制造它们的程序员。希望你不是其中之一。 1.自以为很了不得的程序员 public class Program { static void Main(string args) { string message = "Hello World!"; // 07/24/2010 Bob Console.WriteLine(message); // 07/24/2010 Bob message = "I am so proud of this code!"; // 07/24/2010 Bob Console.WriteLine(message); // 07/24/2010 Bob } }
2015-10-02 10:28 dhirschl, 小峰
我站出来就是为了要说一句: 请注释你那该死的代码。 每次我遇到一个程序员有时是相当高水的总发现他会认为:你并不需要给你的代码加注释。我要说,这就是胡说八道。我很长时间以来一直这么表 达。问题是,让事情 ...
2012-12-03 10:54
分享到微信
打开微信,点击顶部的“╋”,
使用“扫一扫”将网页分享至微信。