程序员吐槽:看了上家写的一行注释,给气死了,可是又不敢删

简介: 程序员最讨厌的事:写注释、别人不写注释、别人写注释的字体和编译器底色相同。那么到底程序员该不该写注释?其实对于写注释这件事来说,还是有一定的争议的,争议其实不在于该不该写注释,而是在于不要过多的写注释,注释多了,反而会让你感觉整个代码比较混乱不堪,影响视觉。

程序员最讨厌的事:

注释、别人不写注释、别人写注释的字体和编译器底色相同。

那么到底程序员该不该写注释?

其实对于写注释这件事来说,还是有一定的争议的,争议其实不在于该不该写注释,而是在于不要过多的写注释,注释多了,反而会让你感觉整个代码比较混乱不堪,影响视觉。而且有人为什么不太鼓励大家过多的去写注释呢?因为代码即注释,何为代码即注释?代码是具有自解释功能的。高质量,命名规范的代码,其实程序员一眼就能够看懂这段代码的功能作用。

今天小编就带大家看看什么叫做“教科书”版注释!

img_633601e157cad09e63656e5b748e58a4.png

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

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

img_ced20a3d30de30110c5be4a451aa2267.png

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

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

(仿佛看到两个程序员相隔时空的diss)

2.

//喝大了,等会再修bug

3.

//有魔法,别碰。

4.

//开森地调bug吧,傻x

(隔着屏幕都想打他一顿)

5.

img_f123417de22d1486b1e5f77995f749ea.png
img_6f04b420b720ad704d199c7be30a6d77.png

/*

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

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

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

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

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

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

*/

6.

//这代码真是烂透了,你懂得,我也懂得。

7.

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

8.

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

9.

img_025240f768eedc9b0dbf6f31115fae3f.png

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

然后翻到文件底部:

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

10.

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

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

11.

//就不给你们写注释

//这代码写得这么费劲

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

12.

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

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

13.

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

14.

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

15.

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

16.

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

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

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

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

17.

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

相关文章
|
Kubernetes API 容器
loki日志收集全网最全教程(强推)
loki日志收集全网最全教程(强推)
|
Java
给网站添加微信扫描二维码登录功能
最近网站PC端集成微信扫码登录,踩了不少坑,在此记录下实现过程和注意事项。
4480 0
|
人工智能 文字识别 监控
将人工智能融入多媒体 助力视频产业加速——阿里云视频AI全能力解读
结合人工智能视频理解流程和用户的需求场景,我们将视频AI的功能分成四个大部分,视频智能审核、视频内容理解、视频智能编辑、视频版权保护。其中视频审核功能包括视频鉴黄、暴恐涉政识别、广告二维码识别、无意义直播识别等,利用识别能力将网络上没营养和不健康的视频内容进行排查和处理;视频理解功能包括视频分类、标签,人物识别、语音识别,同时也包括对视频中的文字进行识别(OCR);视频编辑层面可以实现视频首图、视频摘要、视频highlight的生成,同时支持新闻拆条;关于视频版权,支持视频相似性、同源视频检索和音视频指纹等功能。
17690 0
将人工智能融入多媒体 助力视频产业加速——阿里云视频AI全能力解读
|
JSON 小程序 应用服务中间件
微信的openid是用户的唯一id吗?
【10月更文挑战第4天】微信的openid是用户的唯一id吗?
2356 5
|
Windows
Windows批处理(BAT)文件执行时“一闪而过或闪退”问题及解决方法
Windows批处理(BAT)文件执行时“一闪而过或闪退”问题及解决方法
6097 1
|
小程序
深入理解 uni-app 页面生命周期(四)onShareAppMessage
深入理解 uni-app 页面生命周期(四)onShareAppMessage
1536 0
|
小程序
微信小程序项目实例——图片处理小工具(自制低配版美图秀秀)
微信小程序项目实例——图片处理小工具(自制低配版美图秀秀)
|
JavaScript 前端开发
layui复选框checkbox全选和获取值的解决方案
layui复选框checkbox全选和获取值的解决方案
1944 0
|
小程序
小程序-uniApp:区域滚动、下拉刷新、上拉加载更多
小程序-uniApp:区域滚动、下拉刷新、上拉加载更多
1548 0
|
SQL 缓存 监控
列表查询的通用优化方案
> 列表查询是服务端开发中非常高频的诉求,接口的性能往往会跟用户体验强关联。本文通过一个具体的例子,来总结服务端写查询接口时的通用优化方案。 ## 一个例子 ### 功能诉求 给出一个具体的例子,背景是根据内容ID来查询内容信息(如下),目标是通过编码优化使得这个查询效率变快,减少上游(客户端App或外部服务)的等待时间。 ```java public interfa
1625 2
列表查询的通用优化方案