Linux.中国 - 开源社区

 找回密码
 骑士注册

QQ登录

微博登录


tag 标签:
  • 注释 [7]


相关文章

代码是灵魂,注释是心声
在以前一些关于代码注释的文章中,我发现,你不需要的注释才是最好的注释。不要急着批判,请允许我阐述一下。首先代码应该尽量地简洁,尽可能地做到不需要依赖注释就可以理解。只有那些真的没法更易于理解的代码,才需要我们添加注释。 有一本非常经典的书叫《Structure and Interpretation of Computer Programs》(《电脑程序的结构和编译》),最初发表于1985年,在序言中就表明其观点: 程序必须能便于我们阅读,让机器执行只是附带的。 Knuth也在他1984年发表的经典论文《Literate Programming》(《文学编程》)中秉持了类似的观
2014-11-27 09:22
让那些无用代码注释见鬼去
注释简单代码会干扰对重要注释的理解。程序开发者最好能用最精要的注释来解释重点代码。 举个例子,你打开一个电箱,里面有几百根电线,蒙了吧。再一看,每根电线上面都有一个整洁的小标签。真是谢天谢地啊!但是,当你一个个去翻看标签的时候,见鬼的,几乎所有的标签都是空白的! 然后,在你花了整整一个小时去浏览每一个小标签之后,终于给你找到12条有用的信息,真心喜大普奔!当然,希望在你头脑一片混乱的时候得出的结果仍然是正确的,没有遗漏,呵呵呵。 当我需要研究代码的时候看到到处都是垃圾注释,唉,我的感觉就和上面在那
2014-12-16 13:58
用 HTML 标记的古怪代码注释
现在我明白了,我在编程方面的很多做法都是古怪的、不入流的,不过,对我而言,多多少少是有帮助的。我的网站比大部分网站,肯定存在更多的问题,但是我交付的速度快了不少。你不都懂的。 我从来无法正确学到的一件事,就是注释我的代码。人们通常注释代码的方式如下: 上面的代码是从PHP The Right Way直接摘录的。我纠结的地方在于,代码缩进越深,代码就变得越发难以理解。如果你深入两个 foreach 循环,你该如何知道这部分代码起始何处?问题在于注释无法以某种方式来分割代码。你看不到某段代码的结尾。 你可以使用函数把代码简化为
2015-9-14 10:43
程序员应该避免的 5 种代码注释
你有没有这样的经历:别人审查过你的代码之后给出的注释,你认为是没有必要的?注释代码是为了提高代码的可读性,目的是为了能让其他人更容易理解你的代码。 我特别讨厌这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-2 10:28
8个最没有意义的代码注释
与其说是代码的实际逻辑,还不如说是开发人员自己添加到代码中的注释,对代码产生了颇为深远的影响。这篇文章的主题就是罗列一些我印象深刻的一些代码注释。
2016-2-17 15:51
返回顶部

分享到微信朋友圈

打开微信,点击底部的“发现”,
使用“扫一扫”将网页分享至朋友圈。