大家见过哪些超秀的代码注释？

[复制链接]

gaosmile 发布时间：2020-12-9 20:31

技术帖
文章封面:	-
文章简介:	-

导读：作为程序员，有没有让你感到既无语又崩溃的代码注释？StackOverflow 上有一个类似的问题，问大家见过哪些超秀的注释，不少程序员纷纷吐槽自己见过的那些逆天注释，我们一起来围观一下。

1. 只有上帝知道

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

//现在，只有上帝知道了

2. 相隔时空的diss

//somedev1 - 6/7/02 添加对登录屏幕的暂时追踪功能

//somedev2 - 5/22/07 暂时个屁

（仿佛看到两个程序员相隔时空的diss）

3. 喝大了

//喝大了，等会再修bug

4. 有魔法，别碰

//有魔法，别碰。

5. 开森吗？

//开森地调bug吧，傻x

（隔着屏幕都想打他一顿）

6. 糊弄过去算了

*你可能觉得自己看懂下面的代码了，

*然而你并没有，相信我。

*糊弄过去算了，不然你会好多个晚上睡不着觉，

*嘴里骂着这段注释，觉得自己很聪明，

*真能“优化”下面的代码。

*现在关上文件，去玩点别的吧。

7. 你懂的

//这代码真是烂透了，你懂的，我也懂的。

8. 先往下看

//先往下看，后面再喊我傻X。

9. 好怕怕

//我也不确定我们到底需不需要这个，但是删了又特害怕。

10. 到底要怎样？

#要想理解递归，移步本文件底部

然后翻到文件底部：

#要想理解递归，移步本文件顶部

11. 本人对本代码概不负责

//本人对本代码概不负责，

//他们让我写的，非本人自愿。

12. 我偏不

//就不给你们写注释

//这代码写得这么费劲

//所以你们读着也得费劲

13. 没有错，不好用就不是我写的

//如果这段代码跑的通，那就是Paul DiLascia写的。要是跑不通，

//那我就不知道是谁写的了

14. 没毛病

//这公式没毛病，你要不信自己去算

15. 就问你服不服

//要是你想被炒鱿鱼，那就删吧

16. 好好活着

//如果将来读到这行代码，我会穿越回来，然后一死以谢天下。

17. 谨以此代码献给我的老婆

//谨以此代码和我所有的工作献给我的老婆Darlene，

//这段代码要是放出去，

//她就得照顾我还有三个孩子了。

（潜台词是自己代码写的太烂，会丢了工作或者造成公司倒闭）

18. 我读书少，别骗我

//别删这行注释啊，删了程序就崩了

19. 仇恨绵绵不绝

放个大招，在 GitHub 上有这么一个脚本，前面好好的，很正常，到了中间作者忽然用注释对 Adobe PSD 来了一大段的疯狂吐槽：

//到了这个份儿上，我得给你说说这个 Adobe PSD 格式。

//PSD 可不是个好格式，它甚至都是不个坏格式，叫它坏格式都是

//对 PCX 和 JPEG 这些坏格式的一种侮辱。不，PSD 是一种烂到家的格式。

//我忙活这段代码好几个星期了，我对 PSD 日渐增长的仇恨，

//如同数百万个太阳燃烧成的怒火，绵绵不绝。

//如果有两种不同的做事方法，PSD 会两个都试一遍。

//然后再以正常人无法想象的方式想出三个甚至三个以上的方法，

//把它们也都试一遍。PSD 把“前后矛盾”上升成了一门艺术。比方说，

//为啥它忽然就决定这些特定组块对齐 4 比特，而且这种对齐方式

//不应该包含在尺寸内？其它地方的组块要么没对齐，

//要么对齐方式包含在尺寸内。这里就没包含在内。

//这三种方式任何一种都是可以的，智商正常的格式都会只用一种，

//我们的 PSD 当然是三种都用了，而且不止三种。

//从 PSD 文件里拿到数据，就跟从你那 58 岁生日时被一条抓狂的淡水鲨鱼干掉的

//上岁数的怪叔叔家的阁楼上想找出点好东西一样。

//用鲨鱼这个比方不是我要表达的重点啊，但是我现在正在苦思冥想，

//那些小题大做搞出这种文件格式的人该有怎样搞笑的人生啊。

//之前吧，我想找到这种文件格式的最新说明书。

//为此，我必须向他们申请许可，他们才考虑送我

//这本神圣的“秘籍”。整个过程还得向他们传真

//一些文件的复印件，或者可能还得签点秘密协议。

//我只能觉得，他们把这个流程搞这么复杂就是因为

//他们造出了这么恶心的东西，心里有愧。我是自然不会

//按他们的意思走这个流程的。但是假如我真的

//这么做的话，我会把说明书的每一页都打印出来，

//一把火给它烧了。要是能有超能力，

//我会把说明书的所有复印件都收集过来，

//放到宇宙飞船上，直接发配到太阳。

//PSD 不是我喜欢的文件格式。

看来是实在忍无可忍了。吐槽完这一段后，作者又继续淡定地写完了脚本。

这段脚本的地址：

https://github.com/zepouet/Xee-xCode-4.5/blob/master/XeePhotoshopLoader.m#L108

20. 新人默默的在后面增加一行注释：浪费在这里的总时间=48h 21. 新人看到这样的注释都不用再尝试了，感恩前辈 22. 即使系统终止运行，这个BUG依然存在 23. 只能说下家公司真惨，这是有多大的积怨呢 24. 整个网站就此垮掉...... 25. 敢这么诅咒老板的，我敬你是条汉子 26. 你不可能看懂这个

这是一段来自贝尔实验室的，第六版Unix Kernel，注释语句为“you are not expected to understand this”，意思就是，你不可能看懂这个。

27. 穷逼VIP

去年虾米音乐客户端的程序员竟然称一些活动送的VIP客户为“穷逼VIP“，引发了网友争议。

28. 不解释，看注释 29. 听前辈的话，把这块程序去掉就好了 30. 调试了半天才看到这个，新人表示已泪奔 31. 你有freestyle吗，也来一个？ 32. 顾客要是不会看个代码注释，被坑了可能还不知道 33. 虽然没有年终奖，但我们有很多bug呀！

刚入职的程序员估计会被吓跑，然后感谢一下前辈。