你也会写如此有趣的代码注释吗

约定不等于承诺〃 2023-01-07 07:15 158阅读 0赞

点击上方"蓝字"，关注了解更多

![format_png][]

![format_png 1][]

### 01杀了个产品经理祭天 ###

大概全天下的程序员，都悄悄在代码里藏进了自己对产品举起的那把大刀，而且一不留神，刀尖就露出来了......

> 傻逼的是产品，不是我

![format_png 2][]

> 到底要什么，我也很无奈啊.jpg

![format_png 3][]

▲昕霖是产品经理，李超是设计师

> 锅是产品的，不是我的

![format_png 4][]

### 02 诉求都在注释里了 ###

出来工作，不就是为了赚钱吗？一不小心，真实的想法就在注释里流露。

> 不得不说，该站的程序员，真的很会搞事情。

![format_png 5][]

> [“钱多活少办公室大，最好还能经常去国外旅游并能报销。”学生时代的Sergey Brin也把这个朴素的愿景写在了简历代码的注释里。原来，每个人的职业追求，都差不多。虽然后来的他成了Google联合创始人。][Sergey Brin_Google]

![format_png 6][]

### 03 一不小心，就把实话说出来了 ###

领导和老板们总有那么些不可言说的小心思，不过，程序员们你们也太耿直了吧？！

![format_png 7][]

老板的心机，都被你们暴露了。

/** 老板说多线程先不开，等客户提需求优化 */

当然，同事也并没有多么靠谱。

![format_png 8][]

### 04 隔空喊话，“友好”切磋 ###

在代码注释里，程序员们还能隔着时空通过comment喊话，进行友好地交流与切磋。[如何写出让同事无法维护的代码？][Link 1]这篇了解下。

比如下面这两行注释，就是跨越两年的一段喊话。

![format_png 9][]

不过，一不小心，画风可能就变了，忍不住就Diss了一下。

![format_png 10][]

> //somedev1 - 6/7/02 添加对登录屏幕的暂时追踪功能
> 
> // somedev2 - 5/22/07 暂时个屁

### 05 猿们，要学好英语啊 ###

[还有些注释里，包含着前辈程序员的语重心长：要学好英语啊！否则是会闹笑话的。][Link 2]

> 蓝翔毕业不要紧，重要的是缩写不能乱写：

![format_png 11][]

> 否则后果很严重：

# 不要再用 anal 做变量名了
    # 你们想用 anal 这个缩写来表示analyze（分析），可是 anal 这个单词的意思是“肛门”
    # 我特么在哪都能看到 anal 这个词！
    # 请不要再这么做了！
    # 你们要用就用analyze，或者xbvvzr，要不然用什么其他的都可以。就是别写成 anal_insert 或者 anal_check了
    # insert是插入的意思，check是检查的意思，自行脑补吧

### 06 喜提彩蛋，招聘了解一下 ###

如果你有一双善于发现的眼睛，也许你就能看到，那些藏在Console里的招聘广告。也许，你从此就走上了升职加薪的人生巅峰呢~

![format_png 12][] ![format_png 13][]

### 07离职员工的温馨提醒 ###

不过，跳槽需谨慎。

史上最良心注释，碰到这样的坑，就赶紧撤吧。

![format_png 14][]

### 08 我的代码就像一首诗 ###

最后，写代码就像写一首诗，就像唱一首歌。

![format_png 15][]

这样写注释，代码无bug！

不过，话说回来，你们写代码，居然都写注释？

[format_png]: /images/20221119/c7459daf3957496e93ffc93695d82442.png
[format_png 1]: /images/20221119/c70d5872f5cd4b1f9599039f001f16cd.png
[format_png 2]: /images/20221119/9939bcfeb782495bab6e77f1561bd95b.png
[format_png 3]: /images/20221119/3dc5d02d08d942a69ba169080edfa0fb.png
[format_png 4]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X2pwZy84SmVpYzgyT3IwNGxxRkU5TDNJUFdEQnFENGtDWTBmd1Z4TzN5WmlhcDBpYTNLTHMwcUUyT29Pd3hzbVFvSkJueDZud3d1WU5ESkZXaWE1NTNnQmhzMzluSGcvNjQw?x-oss-process=image/format,png
[format_png 5]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy84SmVpYzgyT3IwNGxxRkU5TDNJUFdEQnFENGtDWTBmd1ZwU2dna2ZBMHdYWkhvTEVPa1Zib0EwMWxIOUowSGZHa0RRbE9XcXlxc1JnTVRUUGlhaWN3WElMQS82NDA?x-oss-process=image/format,png
[Sergey Brin_Google]: http://mp.weixin.qq.com/s?__biz=MzI3ODcxMzQzMw%3D%3D&chksm=eb505a00dc27d3168b8dda2e5126a2a0c1c2ba61a00995a30be7a778d77f3d3b0e41687a1edb&idx=2&mid=2247507766&scene=21&sn=e1486d4d72d21e3b677c7a97c636eade#wechat_redirect
[format_png 6]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X2pwZy84SmVpYzgyT3IwNGxxRkU5TDNJUFdEQnFENGtDWTBmd1ZDTFZmU3FsUTNOMU5JcTVMMjFrNkJGU3ZpYVprUndDeTVodklNOFRXQXp0UUxVdER3amljSkJSdy82NDA?x-oss-process=image/format,png
[format_png 7]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X2pwZy84SmVpYzgyT3IwNGxxRkU5TDNJUFdEQnFENGtDWTBmd1YzRFliRGRDczRscEJZZHdDemhRaWNpYmVaWUlpY0RVY0hxUHMyVHhpYTg4ZmJsamliN2JxVUU1RmtMdy82NDA?x-oss-process=image/format,png
[format_png 8]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy84SmVpYzgyT3IwNGxxRkU5TDNJUFdEQnFENGtDWTBmd1ZrTG5PN0ZrdWljVDNOUjJpYXdwcFNvbk1JcHNRWDB0T3VYSldXTEVWU3FGclkzU2FJb1ZpYnBQcWcvNjQw?x-oss-process=image/format,png
[Link 1]: http://mp.weixin.qq.com/s?__biz=MzI3ODcxMzQzMw%3D%3D&chksm=eb539c0edc241518c010949b0570c474922dd8a5bfe8835953c77025e965693155871417b51d&idx=1&mid=2247489848&scene=21&sn=eef2804f5cc32e781dc57b29df35d98e#wechat_redirect
[format_png 9]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy84SmVpYzgyT3IwNGxxRkU5TDNJUFdEQnFENGtDWTBmd1ZtbWlja2Vhc3N4aEhzYUxrbkJ1SWZ1MGYxU0w3SlQ2bjJCSkw4TXpnTGVod08wUmljSWljcENja3cvNjQw?x-oss-process=image/format,png
[format_png 10]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy84SmVpYzgyT3IwNGxxRkU5TDNJUFdEQnFENGtDWTBmd1Z6WUhYUFNvbElJSUlyaDREbDFpY0lpYmljRzdMUzV6aWNUeHNVQUp5QmljbkxSZlM5ODUzd1I0TjlJUS82NDA?x-oss-process=image/format,png
[Link 2]: http://mp.weixin.qq.com/s?__biz=MzI3ODcxMzQzMw%3D%3D&chksm=eb539c71dc241567d37ef1a47545c983187578951d36bc92b9c90333d18a1efed3c20b8d7306&idx=1&mid=2247489863&scene=21&sn=d11d1f775d66b0895a8ca1440e61d4d1#wechat_redirect
[format_png 11]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy84SmVpYzgyT3IwNGxxRkU5TDNJUFdEQnFENGtDWTBmd1ZTOTdmaHRCc2liaHdPb1dnbmlhSm52YlVZS000OGpvTkJkWHRHZDhVd0poSEEzT2lheGVQZjRkRVEvNjQw?x-oss-process=image/format,png
[format_png 12]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy84SmVpYzgyT3IwNGxxRkU5TDNJUFdEQnFENGtDWTBmd1ZJYlcwbWoybWlibU5yZ1FUeTJHR1lpYkxqV0RHcFkzcngyNXRqUU1oRndqaWFvSkNJOTNJQlM5UmcvNjQw?x-oss-process=image/format,png
[format_png 13]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy84SmVpYzgyT3IwNGxxRkU5TDNJUFdEQnFENGtDWTBmd1ZVNVRRbDV0QjVLSVJZd1BQYnZJMU5hTndPWkNUWmg1aWFVREtHeFZRSDNpYUNVUURRZEhFa0g2dy82NDA?x-oss-process=image/format,png
[format_png 14]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy84SmVpYzgyT3IwNGxxRkU5TDNJUFdEQnFENGtDWTBmd1ZpYmlhTlJjYTUwc2h4SGljQ3piczlpYW1DRWJPMTJ6dWRQSHBUZ3daZ2MyR3pjS2tISW9PaDdkTTFRLzY0MA?x-oss-process=image/format,png
[format_png 15]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X2pwZy84SmVpYzgyT3IwNGxxRkU5TDNJUFdEQnFENGtDWTBmd1ZpY05iMGRRQVpWUDlPb3hZMmhGWU81RTRvYmF3aWM2b2lid2VyR2RzZWFOOHMxZVBucUtvVlRRcEEvNjQw?x-oss-process=image/format,png