注释简单代码会干扰对重要注释的理解。程序开发者最好能用最精要的注释来解释重点代码。 举个例子，你打开一个电箱，里面有几百根电线，蒙了吧。再一看，每根电线上面都有一个整洁的小标签。真是谢天谢地啊！但是，当你一个个去翻看标签的时候，见鬼的，几乎所有的标签都是空白的！ 然后，在你花了整整一个小时去浏览每一个小标签之后，终于给你找到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
现在我明白了，我在编程方面的很多做法都是古怪的、不入流的，不过，对我而言，多多少少是有帮助的。我的网站比大部分网站，肯定存在更多的问题，但是我交付的速度快了不少。你不都懂的。 我从来无法正确学到的一件事，就是注释我的代码。人们通常注释代码的方式如下： 上面的代码是从PHP The Right Way直接摘录的。我纠结的地方在于，代码缩进越深，代码就变得越发难以理解。如果你深入两个 foreach 循环，你该如何知道这部分代码起始何处？问题在于注释无法以某种方式来分割代码。你看不到某段代码的结尾。 你可以使用函数把代码简化为
2015-09-14 10:43 levelsio, 腊八粥
你有要说明的地方吗？请将它们添加到你的 Bash 脚本中。
2023-10-19 11:37 Sagar Sharma, geekpi
在以前一些关于代码注释的文章中，我发现，你不需要的注释才是最好的注释。不要急着批判，请允许我阐述一下。首先代码应该尽量地简洁，尽可能地做到不需要依赖注释就可以理解。只有那些真的没法更易于理解的代码，才需要我们添加注释。 有一本非常经典的书叫《Structure and Interpretation of Computer Programs》（《电脑程序的结构和编译》），最初发表于1985年，在序言中就表明其观点： 程序必须能便于我们阅读，让机器执行只是附带的。 Knuth也在他1984年发表的经典论文《Literate Programming》（《文学编程》）中秉持了类似的观
2014-11-27 09:22
分享到微信
打开微信，点击顶部的“╋”，
使用“扫一扫”将网页分享至微信。
标签: