你见过哪些独特的代码注释？

看过这个： IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD BE LIABLE

FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR

CONSEQUENTIAL DAMAGES
段注释是写在一个修改版的BSD许可证的“限制伤害”条款里的，Bill在他的代码里引用了这个许可证协议。其实它并没有对原先的协议做大的修改，所以很多人看到这个协议以后，一看跟模板差不多，然后就跳过了，几乎没什么人仔细去看整个文字

怎么样，你没见过这条吧。其实很容易就看掉了。有趣的地方正好在这里：

「Bill Paul以及他头脑中的想法绝不会直接，间接，偶然，特殊，典型或实质性地造成任何损害。」

总之，这哥们儿是个天才

看大家讨论的注释都很奇葩啊。。。找了找，分享一下：
/*

• The RealTek 8139 PCI NIC redefines the meaning of 'low end.'

  RealTek 8139 PCI NIC重刷了low逼的下限

• 这可能是史上写得最烂的PCI以太网控制器驱动

• with the possible exception of the FEAST chip made by SMC.>

• The 8139 supports bus-master DMA, but it has a terrible

• interface that nullifies any performance gains that

• bus-master DMA usually offers.

  *

• For transmission, the chip offers a series of four TX

• descriptor registers. Each transmit frame must be in a

• contiguous buffer, aligned on a longword (32-bit) boundary.

• This means we almost always have to do mbuf copies in order

• to transmit a frame, except in the unlikely case where a)

• the packet fits into a single mbuf, and b) the packet is

• 32-bit aligned within the mbuf's data area. The presence of

  • only four descriptor registers means that we can never have

  • more than four packets queued for transmission at any one

  • time.

  *

  • Reception is not much better. The driver has to allocate a

  • single large buffer area (up to 64K in size) into which the

• chip will DMA received frames. Because we don't know where

• within this region received packets will begin or end, we

• have no choice but to copy data from the buffer area into

• mbufs in order to pass the packets up to the higher

• protocol levels.

  *

• It's impossible given this rotten design to really achieve

  要让这么烂的设计去达到100Mbps的速度简直就是天方夜谭

  • decent performance at 100Mbps, unless you happen to have a

    除非你有一台CPU强劲的电脑去驱动

  • 400Mhz PII or some equally overmuscled CPU to drive it.

  *

  • On the bright side, the 8139 does have a built-in PHY,

  • although rather than using an MDIO serial interface like

  • most other NICs, the PHY registers are directly accessible

• through the 8139's register space. The 8139 supports

• autonegotiation, as well as a 64-bit multicast filter.

  *
  哈哈哈

来一个：
/ You are not expected to understand this /

/ 我们并不指望你能看懂这段话 /
还看到过一个更牛逼的，
/ Do NOT delete this comment /

/ 不要删除这段注释 /

哈哈，代码注释太有意思了，留给后进公司的人看...

// 使用这段代码就像穿越时空一样，小心不要改变过去和未来。

之前在公司看到一个注释
// 代码就像生活，充满了不确定性和可能性。

还有
// 这个循环看起来像是在无限循环，但它其实不是，真的不是，我保证。
for i in range(0, 10):
pass

还有这个：

//我写这一行的时候，只有上帝和我知道我在写什么

哈哈

公司小伙一个个都是人才啊

见过用符号画了个图的，这个程序员一定内心很可爱。
当然普遍的还是对方法和代码逻辑解释的注释。这就会出现过期的注释，就是功能其实已经进行改变了，但是程序员并未对注释进行修改，这就对后续维护的人带来困扰。可能需要找产品经理确认、仔细阅读整段代码逻辑才可以了解逻辑。
为了避免这种情况最好就是做代码审查。

//毁灭吧~
看出来他的心情了

Linux 内核源码： Linux内核是著名的开源操作系统内核，其源码中有一些经典的注释。例如，在include/linux/time.h文件中，可以找到如下有趣的定义：
/* The epoch for time() and friends */
#define EPOCH 1970

这里的注释使用了"The epoch for time() and friends"这样略带幽默的描述，表示1970年是时间函数的起点。

// ┏(--)┛┗(-- )┓┗(--)┛┏(--)┓
// Loop through the array and perform calculations.
for (int i = 0; i < array.length; i++) {
// Perform calculations here
}

//抓紧，我们要跳进分形兔子洞了！
在一些比较复杂的难懂的代码前面注释，可以起到放松心情的作用，更加有利于代码的理解，有积极作用

//啊！终于完成了这个怪物的功能。该喝杯咖啡休息了。
表达出当时的心声，估计后续读到这段代码的人也会有相同的感想

// This method works like a charm. Don't ask me how, it just does.
这种方法非常有效。别问我怎么做，它就是这样。

// \ (^_^) /
// Congrats! The operation was successful.

用一些图案来表达成功的心情

// ┏━━━━━━━━━━━━━━━━━┓
// ┃ Code Section ┃
// ┃ Why did the ┃
// ┃ chicken cross ┃
// ┃ the road? ┃
// ┃ To get to the ┃
// ┃ other side! ┃
// ┗━━━━━━━━━━━━━━━━━┛

有的会在注释在写一些笑话，来让工作更加有意思一点，自娱自乐的方式，也给后续开发者提供点欢乐

很多会有彩蛋注释（Easter egg comments）：这些注释隐藏在代码中，通常是一些有趣或令人惊喜的内容，只有在特定条件下才会显示出来。例如，当某个特定的输入出现时，会显示一条有趣的消息或动画。
// TODO: Add unicorn magic here 🦄

// 请在未来的某个时刻，为这段代码编写单元测试。

后续的测试非常重要，是应该时刻牢记

// WARNING: Don't touch this code unless you're absolutely sure what you're doing!

提示这段代码可能涉及的面比较广，需要更加仔细

// I have no idea why this works, but it does. Yay!

有时候代码就是这样，很神奇

有的会在代码注释中加入当时的心态，比如写这个方法的时候有多困扰，对产品经理的吐槽等，然后写下一个方法的时候的心态的转变：一切都会好起来等

佛祖保佑