多年前，我遇到了这样一个问题:

/***************************************************************************/
/*  deep wizardry. do not touch.                                           */
/*                                                                         */
/*  no seriously.  XXXXXX I'm looking at you. If you screw with this again */
/*  I will kill you with my swingline stapler.                             */
/*                                                                         */
/* ...                                                                     */

然后描述了一个特别复杂的算法。

好吧，这些是我的，所以WTF是我，正如CodingHorror所说:

//#region Code for weird cases - do you really want to know?

我曾经在一些ASP中留下了这样的评论:

' Commented out following code, don't delete for when [CustomerName] changes his mind

碰巧，[CustomerName]没有改变他的想法，但他确实有访问web服务器，他确实找到了那行…

很久以前，我遇到了一些连接脚本，虽然我不记得语法，但我记得注释，因为我是平克·弗洛伊德的粉丝。

//Attempt Handshake: Hello? This is London calling. Are we reaching you?


//Handshake Failed: I don't understand...he just hung up.

//Abandon all hope ye who enter beyond this point

这不是严格意义上的评论，但是…

那是20世纪90年代中期，我正在进行一次大的迁移:小软件供应商，大客户，压力很大。我们有很多转移门柱的东西;这个项目很难控制。我是关键的开发人员，但对系统还不熟悉，而另一个开发人员是供应商的所有者/创始人。

在几个月没有按时完成任务，也没有让客户满意之后，公司的所有者/创始人找来了另一名远程工作的开发人员。(我可以大胆地说，新开发人员的技能和经验都不如我。)

好吧，这个新人对我已经做过的代码做了一些更改，然后一两个月后我又回到了代码的同一区域，其中有一些我以前没有见过的变量。他的名字叫StupidMark。

伙计，这是不对的。我的意思是，有团队合作方面的考虑，但是:在这个环境中，变量名可能会出现在运行时错误消息中。我只是说说而已。

在我看来，那个新人的代码并没有让我们更接近可交付的产品，这让侮辱变得更伤人了。

在几年前编写Perl时，我在顶部和底部添加了这些注释:

# <magic type="voodoo">

...

# </magic>

下一个研究它的人在Perl中并不是那么热门，他花了一段时间搜索文档，看看“魔法”和“巫毒”是怎么做的。从那以后，我试着添加更多有用的评论……