IT行业敲代码是常识,写注释却不是。
代码是给计算机看的,而注释则是给程序员看的。
编译器并不会编译注释里的内容,这就给了程序员们尽情发挥的空间。
注释的画风也随之变得有些奇怪了起来……
// drunk, fix later
// 喝多了,待会儿再改
这位程序员大哥在写下这个注释时,起码还是很负责的。只是,后面酒醒之后,要么忘了改bug,要么忘了删注释……
// Magic. Do not touch!
// 魔法,别动!
一坨莫名其妙的祖传代码突然映入了脑海,难道这就是魔法的力量吗?
//
// Dear maintainers:
//
// Once you are done trying to 'optimize'
// this routine, and have realized what a
// terrible mistake that was, please
// increment the following counter as a
// warning to the next guy:
//
// total_hours_wasted_here = 42
//
//
// 亲爱的维护者:
//
// 一旦你试过“优化”这个程序
// 并意识到这是个多么可怕的错误
// 请增加下面的计数器作为警告
// 提示下一个家伙:
//
// 这里总共浪费的小时数 = 42
//
这个数字每次增加,就会有一位头铁的程序员留下悔恨的泪水,瑞思拜!
/* Do NOT delete this comment */
/* 不要删除这段注释 */
这个注释就有点耍流氓了。但很遗憾,在你看到这个注释的时候,已经有很多人尝试过删掉这个注释了。
结果显而易见,所有删掉这段注释的程序员最终都把这段注释加了回来。不光代码是魔法,注释也是……
如果说这些注释还在插科打诨,耍耍小幽默的话,下面这些注释会为你打开一个新世界……
这位程序员机智地用符号表示出了边框样式和填充图案样式,这可能要比纯文字描述要直观几十倍!
为了对抗神出鬼没、来无影去无踪的bug,程序员们甚至动用了神兽之力,还有一些甚至开始……
果然,老爹说的是对的:“必须用魔法打败魔法”。
天知道这些程序员们代码改不完的时候,都在想些什么鬼东西……
看完这些注释之后,难道还会有人觉得程序员死板木讷情商低吗?可能程序员的幽默也需要被人理解吧。
就像谷歌联合创始人之一谢尔盖.布林,攻读博士期间,他在自己的简历html源代码中加入了待遇要求,只不过用注释注释掉了。
待遇要求:大办公室,高薪酬,非常少的工作。
如果能经常去奇妙的地方旅行而且还能给报销的话,那就更好了。
有人写注释,就一定有人不写注释。
如果说有时候,一个注释可以让人在烦扰中会心一笑,那完全找不到任何注释,质量又不高的代码也可以摧毁一位程序员一整天的好心情。
对整个项目而言,注释确实没有创造什么额外的价值;但对于项目中的每个程序员来说,这些注释简直就是救星,没有它们几乎寸步难行。
正因为注释的存在,程序员们那些梦想中的诗和远方,幽默和吐槽才有挥洒的余地。感谢注释为这枯燥的项目和生活增添了一丝活力。
当然,下面这个注释最好是真的,否则指不定出什么岔子……
// sometimes I believe compiler ignores all // my comments
// 有时候,我相信编译器忽略了我所有的注释