今天最窝心的文字:码农最讨厌两件事儿

2018-08-17 15:04:33 +08:00
 quu

码农最讨厌两件事儿:

1.码代码的时候写注释 2.接手别人代码没注释

真的扎心了,我先笑十分钟。

8875 次点击
所在节点    程序员
54 条回复
fhefh
2018-08-17 15:06:52 +08:00
刚刚在一篇微信推文看到这句话 哈哈~
WhatC
2018-08-17 15:14:22 +08:00
1 相对还好吧,自己再捋一遍思路也 ok,2 这个就爆炸了,就怕留了个烂摊子给你。
hxhc
2018-08-17 15:31:02 +08:00
个人觉得写注释其实蛮舒服
xujinkai
2018-08-17 15:32:50 +08:00
接手代码没注释和接手代码一行一个注释哪个更不爽?
noNOno
2018-08-17 15:32:57 +08:00
1.个人觉得先理清楚逻辑蛮好的,逻辑变成文字就是注释
2.喵喵喵???
ChiangDi
2018-08-17 15:35:33 +08:00
再多注释也救不了傻逼代码
jamfer
2018-08-17 15:38:24 +08:00
男人最讨厌的两件事
1.ML 要戴套
2.GF 不是处
littleylv
2018-08-17 15:39:13 +08:00
致远星战况如何?
Decouple
2018-08-17 15:41:03 +08:00
代码即注释了解一下,合理的结构和高可读的命名,绝大部分的注释可以通过高质量的代码来避免
zsdroid
2018-08-17 15:42:40 +08:00
码农最讨厌两件事儿:一件事是改需求,另一件事还是改需求
michaelcheng
2018-08-17 15:43:57 +08:00
我挺喜欢写些注释的,因为有些代码,过两天自己都会忘
Decouple
2018-08-17 15:48:21 +08:00
@Decouple 再补充一句,忘了在哪看到的,大意是,注释是一种对失败的妥协,表达出来的意思是:我写出来的这段代码别人(甚至不久后的自己)很难看懂,所以我不得不加点文字
night98
2018-08-17 15:48:40 +08:00
@Decouple #9 这个东西基本上等于扯犊子,超过 100 个 class 以上就基本上不成立了。
sambawy
2018-08-17 15:50:22 +08:00
代码写得优雅一点 有没有注释都能看 代码写得烂一点 有注释都不想看
mathzhaoliang
2018-08-17 15:54:26 +08:00
@Decouple 这种说法明显教条了。高质量的代码往往离不开高质量的注释,注释和代码的比例往往大于 1。试想一下在逻辑复杂的项目里面没注释的话,也许别人每一行都看得懂,但连起来就看不懂。
Decouple
2018-08-17 15:55:36 +08:00
@night98 为何得出这样的结论?粗略看了一下手头的项目,class 文件早已超过 200 个,然而注释极少,即使有注释也大多是一些对尚未完成功能的说明,而且注释为什么会和项目大小有很强的关系?如果结构复杂那应该用文档来说明而不是注释
Decouple
2018-08-17 16:02:14 +08:00
@mathzhaoliang 我认为的是很多复杂的逻辑完全可以分解成数个简单的小模块再组合在一起,比如一个上百行的方法是很难保证可读性的,但是如果把逻辑拆分开最后变成一个十五行的方法,可读性肯定有很大提升。当然只针对大部分情况,无法拆分的另当别论
Light3
2018-08-17 16:08:02 +08:00
我还是比较烦 就是这个样子你快做啊 今天需求 今天上线
注释这个 不用太复杂 大体写一下每个 方法的 用处不就完了吗
qiuqiuer
2018-08-17 16:09:03 +08:00
1 产品经理想事情
2 产品经理想到事情
night98
2018-08-17 16:11:57 +08:00
@Decouple #17 以一个简单的页面显示分页为例。
方法 1 为通用分页,用户首次进入显示该方法数据,需要添加缓存
方法 2 为条件分页,用户筛选后显示该方法数据,需要添加缓存
方法 3 为默认条件分页,用户点击按钮后显示该方法数据,数据已缓存到内存
三个方法入参格式一致,返回格式一致

请问你如何通过命名来直接区分三个方法,以及在其他人阅读时无歧义的理解该方法作用?

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/480741

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX