如果写程序不愿写注释，只有一个原因

作者 | Sheetal

译者 | 弯月 责编 | 王晓曼

有时候，我们会写一些非常有创意的注释，而有些注释确实让人不得不佩服 程序员的想象力。看到下面这些注释，相信每个人都会捧腹大笑。

【1】

#想了解递归，请参见文件末尾
.
.（代码末尾…）
.
#想了解递归，请参见文件开头

【2】

//仅以这些代码和我所有的工作献给我的妻子 Darlene，
//因为一旦这些代码发布，她就不得不全力支持我、我们的三个孩子，还有狗狗。

【3】

//有时，我相信编译器会忽略我所有的注释。

【4】

/*
你以为你知道下列代码在干什么。
其实你并没有。相信我。
与这段代码相爱相杀，你会度过无数个不眠之夜。
你认为你聪明有余，足以“优化”下面这段代码的那一刻，诅咒就将开始。
听话，关闭这个文件，去玩点别的吧。
*/

【5】

//我不确定我们是否需要这段代码，但我不敢删。

【6】

// 捕捉异常是一项共产主义事业。

【7】

//如果我从未来穿越回来读这段代码，我会回到过去，干掉我自己。

【8】

floatboat; // 船必须能漂浮（float也有漂浮的意思），否则就沉了。

【9】

try{} finally { // 应该永远不会发生
}

【10】

//我被迫写下这段代码，非我个人所愿。

【11】

//写起来真麻烦，
//所以读起来也很麻烦。

【12】

//如果这段代码能够正常工作，那么请记住作者是Atit Patel。
//如果不能正常工作，那我也不知道是谁写的。

【13】

//如果你在阅读这段代码，那意味着你接手了我的前一个项目。非常抱歉，真心为你感到难过，祝你成功。

【14】

//昨天我被吓到了，
//我运行了一些本不存在的代码，
//今天却发现这段代码不见了；
//我多么希望这段代码能留下来。

【15】

//如果这段代码仍在使用中，但无法正常工作，那么
//我允许你向我开枪。哦，其实你开不了枪，
//因为那时我已经死了……

【16】

/* Ultra-hot screen management package
JamesGosling, January 1980 /
/ Copyright© 1981,1980 James Gosling /
/***************************************************************
/-------------
/
/
/
| XXXX XXXX |
| XXXX XXXX |
| XXX XXX |
\ X /
–\ XXX /–
|| XXX | |
|| | |
| II I I I I I |
| I I I I I I |
\ /
– –
XXX XXX
XXXXX XXXXX
XXXXXXXXX XXXXXXXXXX
XXXXX XXXXX
XXXXXXX
XXXXX XXXXX
XXXXXXXXX XXXXXXXXXX
XXXXX XXXXX
XXX XXX
**************
* 当心!! *
**************
警告所有闯入者:
本模块中的大部分代码
都极度扭曲！
小心处理。
你以为你理解这些代码？
不，你并没有，
再仔细看看。
****************************************************************/

【17】

//删了这条注释，程序就会挂掉。

【18】

//这段代码是 Sheetal 编写的，没人知道是干什么的，千万别改！

【19】

//下面这段代码是黑魔法，
//来自某个 stackoverflow 链接。
//请不要玩魔法，会伤到人。

【20】

//请 James Gosling 原谅我即将犯下的罪行。

【21】

//本来这段代码能够正常工作，但我的猫猫决定，
//在我的键盘上来一场旅行……

【22】

//私有实例变量，用于存储年龄，
public static int age;

【23】

//我不确定为什么这段代码能够正常运行，但问题确实修复了。

【24】

longtime; /* 学习 C（要花很长时间）*/

【25】

/*哈哈哈！你永远也想不明白为什么这段代码能够正常运行。*/

【26】

//在此设置断点，你永远也运行不到这里。

【27】

//如果你看到这条注释，那么说明我的程序可能成功了。

【28】

//这段代码很垃圾，但已经凌晨3点了，我必须做一个了结。

【29】

//将 i 加 1
i ;

【30】

//Steve 没有发送属性，多么令人开心的创意啊。
//下面我们使用可用的信息重新创建一次。
// 这个逻辑不应该在这里，但我没耐心了，
//就这样吧 // TODO：等待 DAN 修复这个问题。Wes，你别，你可千万别再掺和了。

【31】

//新罗马人（Times New Roman）？老罗马人都怎么了？

【32】

// return
return;

【33】

private
// 私有代表隐私，所以没有注释。
function LoadIt(IntID:Integer): Integer;

【34】

// 没错，这段代码会在3001年出问题，但首先到那时我已经死了；
// 其次，到那时我们真的应该使用不同的系统了。

if (yearPart >= 01)
{
// 不听话的字节已被删除……
}

【35】

/**
* 实现 PaymentType 接口。
*/
public class PaymentTypePo implements PaymentType

【36】

/* 这段代码不好。
TODO：改掉 */

【37】

// 哇，现在这个 if 条件语句好大。

【38】

// 如果可以，请原谅我！

【39】

// 亲爱的维护者：
// 在你放弃尝试“优化”这个例程，
// 并意识到这是一个多么可怕的错误，
// 请将你浪费掉的时间加到下列统计数目中，
// 作为给下一个人的警告：
//在此处浪费掉的小时数 =42

【40】

#define TRUE FALSE // 慢慢调试吧，傻瓜

【41】

/**永远返回 true。*/
public boolean isAvailable()
{
return false;
}

【42】

int getRandomNumber()
{
return 5; //这个值是我掷骰子得到的，
//保证是随机的。
}

【43】

long long ago; /* in a galaxy far far away */（注：星球大战片头字幕）

【44】

stop(); // Hammertime!（注：Stop! Hammertime为美国歌手MC哈默的一句流行歌词）