标签目录：代码注释

2015
08-21

程序员应该避免的5种代码注释

你有没有这样的经历：别人审查过你的代码之后给出的注释，你认为是没有必要的？注释代码是为了提高代码的可读性，目的是为了能让其他人更容易理解你的代码。我特别讨厌这5种注释类型以及制造它们的程序员。希望你不是其中之一。1.自以为很了不得的程序员publicclassProgram{staticvoidMain(string[]args){stringmessage="HelloWorld!";//07/24/2010BobConsole.WriteLine(messag... 继续阅读 >

2015
06-05

代码注释中的5要与3不要

代码注释，可以说是比代码本身更重要。这里有一些方法可以确保你写在代码中的注释是友好的：不要重复阅读者已经知道的内容能明确说明代码是做什么的注释对我们是没有帮助的。//Ifthecolorisred,turnitgreenif(color.is_red()){color.turn_green();}要注释说明推理和历史如果代码中的业务逻辑以后可能需要更新或更改，那就应该留下注释:)/*TheAPIcurrentlyreturnsanarrayofitemseventhou... 继续阅读 >

2014
12-24

9个最有趣的代码注释

我看到过很多有趣的代码注释，有的让我会心一笑，有的简直要笑掉我的大牙，有的甚至隐藏在源代码中。下面让我们一起见识一下这些“笑料”吧。1.原先我还知道我在写什么，但是现在，只有上帝知道了。这条注释是优秀数学家KarlWeierstrass写的。我唯一想问的是，他前后指的是不是同一个数学难题。如果是，那又是为什么，我真的非常想知道。2.谨将我的所有代码所有工作献给我的妻子Darlene，因为她养育了我和我... 继续阅读 >