3.4.2节参考资料：21个奇葩注释数据猿媛程序猿媛技术人猿媛男默女泪.pdf

Code review 到底看什么？ 如何注释 Code review 是检查代码的一种有效手段，然而，到底如何 code review？从前面的故事 我们看到，衡量代码质量的唯一方法就是每分钟的开骂次数。但是，这并没有回答我们心中 的疑问，我们究竟该如何检查源代码。 这次让我们谈谈注释吧。 程序猿最痛恨的一件事情是看别人写的没有注释的程序， 但是， 程序猿同时也最常干的一件事情是不写注释。 那么， 注释该怎么写呢？请大家不妨读读下面 这篇文章。 21个奇葩注释， 数据猿媛程序猿媛技术人猿媛， 男默女泪。 程序员之家 10 月 13 日 微信又改版了，为了方便第一时间看到我们的推送，请按照下列操作，设置“置顶”： 点击上方蓝色字体“程序员之家”-点击右上角“”-点击“设为星标”。 可以啦，让我们继续相互陪伴。 【1】 新人默默的在后面增加一行注释：浪费在这里的总时间=48h 【2】 新人看到这样的注释都不用再尝试了，感恩前辈 【3】 即使系统终止运行，这个 BUG 依然存在 【4】 只能说下家公司真惨，这是有多大的积怨呢 【5】 没有错，不好用就不是我写的 【6】 整个网站就此垮掉. 【7】 敢这么诅咒老板的，我敬你是条汉子 【8】 这是一段来自贝尔实验室的，第六版 Unix Kernel，注释语句为“you are not expected to understand this”，意思就是，你不可能看懂这个。 【9】 去年虾米音乐客户端的程序员竟然称一些活动送的 VIP 客户为“穷逼 VIP“， 引发了网友争议。 【10】 不解释，看注释 【11】 听前辈的话，把这块程序去掉就好了 【12】 调试了半天才看到这个，新人表示已泪奔 【13】 你有 freestyle 吗，也来一个？ 【14】 顾客要是不会看个代码注释，被坑了可能还不知道 【15】 刚入职的程序员估计会被吓跑，然后感谢一下前辈。 【16】 就连 Nike 也尝试了在他们的 robots 文件里加入了一个有趣的图案： 【17】 超级有自知之明的代码注释 【18】 致敬每一个勇敢的编程骑士 【19】 当然，闲的蛋疼的猿，还会做这样的注释： 或者这样的： 甚至这样的： 【20】 看了这么多注释，最喜欢的还是这两个 【21】 最后，送给广大开发者们，恭祝代码无 Bug 你有没有被这 21 个奇葩注视戳中痛点！在敲代码的过程中拥有一个讲究得体的格式 风格态度，是多么重要的事情！