下面是stackoverflow网站上网友针对你看到过的最好的代码注释是什么样的?这个问题给出的回答的前10条:
-
// 亲爱的维护者: // 如果你尝试了对这段程序进行‘优化’, // 并认识到这种企图是大错特错,请增加 // 下面这个计数器的个数,用来对后来人进行警告: // 浪费在这里的总时间 = 39h
-
/** * 致终于来到这里的勇敢的人: 你是被上帝选中的人,英勇的、不辞劳苦的、不眠不修的来修改 我们这最棘手的代码的编程骑士。你,我们的救世主,人中之龙, 我要对你说:永远不要放弃,永远不要对自己失望,永远不要逃走,辜负了自己。 永远不要哭啼,永远不要说再见。永远不要说谎来伤害自己。 */
-
Exception up = new Exception("Something is really wrong."); throw up;
-
// 一些修改1 - 2002/6/7 增加临时的跟踪登录界面 // 一些修改2 - 2007/5/22 我临时的犯傻
-
#define TRUE FALSE //逗一逗调试程序的傻瓜们
-
if (/*you*/ $_GET['action']) { //celebrate(恭喜)
-
// 如果这段代码好用,那它是Paul DiLascia写的。 //如果不好用,我不知道是谁写的。
-
//写这段代码的时候,只有上帝和我知道它是干嘛的 //现在,只有上帝知道
-
// 晕了,以后再修改
-
// 神奇。勿动。
你有没有更绝的?
我发现我写的代码注释和第四个有点像……糟了
囧啊,我的代码里都是FIXME居多
最后一个应该是”魔法。勿动。”吧
原贴被删了?
第五条太坑爹了吧!
崩溃中……
坑死人/.///
看这种注释就是浪费时间啦。
/*有问题去找需求方 他们让这样搞的 – vincent 2011-9-21*/
嘿嘿
真的会写这种
/*如果你能弄清楚这一段,求求你务必发邮件至aaa@bbb.com告诉我,不胜感激*/
/* Write once debug every的精髓之所在 */
// 这个不知道是谁写的 看起来没用,但我不敢删
有意思
// 勇士,乐观的接收这个现实吧!leizisdu, 2011-11-23
前来观望的第四类~~~
// For test—————————May be
我看到这段注释的时候确实有种想吐血的冲动。。。
// 2011-12-21 虽然我也不想这样做,但是有个讨厌的家伙就要我这样做,迟早会证明,他是错的。
这个绝
################
# DEBUG
################
/*
*2012-01-05 19:39:24
*/
坑爹的注释
//下n行代码,下个月重构
//元芳你怎么看?
//就他妈这样了吧
= =我见过最后那个…
// todo xxx
这个TODO不是很正常吗?
/**
*如果你发现了这里有一些bug,那么恭喜你发现了我在2011-07-06时发现的问题
**/
注释很有意思
注释不错,准备放到code中
很不错的注释哟
其实第三条的注释是
Exception up = new Exception(“Something is really wrong.”);
throw up; //ha ha
哈哈
return 1; //返回 1
无可挑剔…….
/**
* 这个方法是我写的,。。。。。。。。。
*/
/*
你懂的!
*/
这翻译实在不怎么好,很多原来英文的意味没表达出来,特别是第四条直接翻译错误。
第四条的正确翻译应该是:
// 一些修改1 – 2002/6/7 在登录界面临时增加的一些追踪代码
// 一些修改2 – 2007/5/22 临时你妹啊!
(意思是过了5年这些所谓“临时”代码还没有被去掉直到第二条注释的作者发现它)
# 这个前端真是¥%%*(……%@
throw new Exception(“It’s not your fault.”);
这是我最喜欢的异常了
修改别人的代码,修改自己未加注释的,自以为很简单的老代码,都是非常让人头痛的。
8、9躺枪的自觉加一~
看到最后我笑了,都能想想的到当时的场景
nice
其实感觉最坑爹的注释是没有注释
我看过的注释里面直接写PM一点儿不懂技术,把构造改了又改
后期还写到这个代码的复杂性正在以光速的方向里你的神经网络分离。
还有写到我不会写我的邮箱在这代码里面,因为我可以肯定告诉你,这代码离开
我后,维护的时候别找我。估计我比现在啃代码的你还了解的不多。
这代码来自于一个奇葩的项目。
// 项目经理让这里运行缓慢一些,以后好让客户优化加钱
sleep(5000);