10个最“优秀”的代码注释
jopen 13年前
<p>下面是stackoverflow网站上网友针对<a href="http://stackoverflow.com/questions/184618/what-is-the-best-comment-in-source-code-you-have-ever-encountered?page=1&tab=votes#tab-top" target="_blank">你看到过的最好的代码注释是什么样的?</a>这个问题给出的回答的前10条:</p> <ol> <li><pre><code>// 亲爱的维护者: // 如果你尝试了对这段程序进行‘优化’, // 并认识到这种企图是大错特错,请增加 // 下面这个计数器的个数,用来对后来人进行警告: // 浪费在这里的总时间 = 39h</code></pre></li> <li><pre><code>/** * 致终于来到这里的勇敢的人: 你是被上帝选中的人,英勇的、不辞劳苦的、不眠不修的来修改 我们这最棘手的代码的编程骑士。你,我们的救世主,人中之龙, 我要对你说:永远不要放弃,永远不要对自己失望,永远不要逃走,辜负了自己。 永远不要哭啼,永远不要说再见。永远不要说谎来伤害自己。 */</code></pre></li> <li><pre><code>Exception up = new Exception("Something is really wrong."); throw up; </code></pre></li> <li><pre><code>// 一些修改1 - 2002/6/7 增加临时的跟踪登录界面 // 一些修改2 - 2007/5/22 我临时的犯傻</code></pre></li> <li><pre><code>#define TRUE FALSE //逗一逗调试程序的傻瓜们</code></pre></li> <li><pre><code>if (/*you*/ $_GET['action']) { //celebrate(恭喜)</code></pre></li> <li><pre><code>// 如果这段代码好用,那它是Paul DiLascia写的。 //如果不好用,我不知道是谁写的。</code></pre></li> <li><pre><code>//写这段代码的时候,只有上帝和我知道它是干嘛的 //现在,只有上帝知道</code></pre></li> <li><pre><code>// 晕了,以后再修改</code></pre></li> <li><pre><code>// 神奇。勿动。</code></pre></li> </ol> <p>你有没有更绝的?</p> 本文转载自: 外刊IT评论 <a href="/misc/goto?guid=4958183272158702965" rel="nofollow" target="_blank">http://www.aqee.net/</a>