起航学习网

- 让每个人都能学到最前沿新知识、新技能!
起航学习网
当前位置: 起航学习网 > 短期培训 > 编程语言 > 程序员到底该不该写注释

程序员到底该不该写注释

时间:2019-01-21 17:34:55来源:编程网 作者:IT培训网 已有: 名学员访问该课程

  快捷搜索:程序员

前言://谨以此代码和我所有的工作献给我的老婆Darlene, //这段代码要是放出去, //她就得照顾我还有三个孩子了。 (潜台词是自己代码写的太烂,会丢了工作或者造成公司倒闭) 17. //别删这行注释啊,删了程序就崩了

程序员吐槽:看了上家写的一行注释,气炸!网友:那你敢删吗?

程序员最讨厌的事:

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

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

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

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

程序员到底该不该写注释_www.epx365.cn

0.

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

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

程序员到底该不该写注释_www.epx365.cn

1.

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

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

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

2.

//喝大了,等会再修bug

3.

//有魔法,别碰。

4.

//开森地调bug吧,傻x

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

5.

程序员到底该不该写注释_www.epx365.cn

程序员到底该不该写注释_www.epx365.cn

/*

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

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

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

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

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

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

*/

6.

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

7.

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

8.

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

9.

程序员到底该不该写注释_www.epx365.cn

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

然后翻到文件底部:

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

10.

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

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

11.

//就不给你们写注释

//这代码写得这么费劲

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

12.

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

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

13.

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

14.

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

15.

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

16.

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

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

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

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

17.

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

文章出自:http://qh.itpxw.cn/peixun/software/201946517.html

文章标题:程序员到底该不该写注释



免责声明:本站文章均由入驻起航学习网的会员所发或者网络转载,所述观点仅代表作者本人,不代表起航学习网立场。如有侵权或者其他问题,请联系举报,必删。侵权投诉

(责任编辑:IT培训网)
顶一下
(0)
0%
踩一下
(0)
0%
------分隔线----------------------------
培训学校
IT培训网 访问该机构站点 报名留言 加为好友 用户等级:注册会员 用户级别:10 机构名称:IT培训网 联 系 人:罗老师 联系电话:13783581536 联系手机:13783581536 在线客服:起航学习网客服 在 线 QQ:起航学习网客服 电子邮件: 网站域名:http://www.itpxw.cn 注册时间:2016-07-18 11:07 最后登录:2024-02-20 13:02
推荐内容