同事写的注释实在太多余了

2020-08-23 13:18:32 +08:00
 wuzhouhui
例如声明变量和函数之前, 都要写一行注释

// 声明变量
// 声明函数

大家都是成年人, 哪有人不知道这是在声明, 至于写个注释吗? 放锁写个注释, 解锁再写个注释. 都三十好几的人了, 也不看看其他人是怎么写代码的, 都说了不要写多余的注释, 还不肯改
16342 次点击
所在节点    程序员
103 条回复
dodoa
2020-08-24 11:52:54 +08:00
不瞒你说,我们代码里想看到一行注释真是太难了。。两个极端啊这是
chenyu8674
2020-08-24 11:54:41 +08:00
// 这是我的回帖
zhady009
2020-08-24 12:07:56 +08:00
变量上的注释应该要说明是干嘛用的 而不是 // 声明变量
coderunI
2020-08-24 12:13:17 +08:00
写个注释,这个也得拿出来说说吗?做你同时太难了。
kingwl
2020-08-24 12:15:09 +08:00
![comments]( )
tachikomachann
2020-08-24 12:19:16 +08:00
不知道原来代码是怎么样的,就我的经验,这么写的人有的时候是强迫症,让大段的代码看起来有分块的感觉,可以第一眼找到某个“块”
OHyn
2020-08-24 12:34:18 +08:00
不愿意写注释的,代码质量统一算作不及格,有愿意写的算是对得起工作了。我这有一个同事,从不写注释,现在他自己已经不知道他写的代码会怎么运行了。
mxT52CRuqR6o5
2020-08-24 12:52:43 +08:00
这是有 78 个人认为这种注释是合理的?
jsonfork
2020-08-24 13:35:54 +08:00
可能是在凑代码行吧。。
xuewuchen
2020-08-24 13:50:24 +08:00
注释这东西贵精不贵多,注释一些逻辑问题和函数实现意义啥的就行了。。当然我不会鄙视楼主说的写无用注释的
Mac
2020-08-24 13:52:51 +08:00
注释不是写给你看的
newtype0092
2020-08-24 14:01:03 +08:00
写这种注释不是因为对自己要求严格处处注释,单纯是因为这样可以不动脑子随便复制粘贴。
这种人真的需要写注释的逻辑往往不会去管,因为需要动脑子。

楼上某些人,明显就是不知道要动脑子的,要是全写这种注释有个二极管就控制了,干嘛养你个吃白饭的?
luxinfl
2020-08-24 15:19:35 +08:00
我都是写整段注释+逻辑判断在方法名上面。代码里面偶尔带上判断条件注释
newtype0092
2020-08-24 15:23:01 +08:00
@edk24 #78

打开链接,从上往下看
排版舒适
段落合理
通俗易懂
由浅入深
好文章啊好文章

最后
威尔史密斯!
我是谁?我在哪?
shm7
2020-08-24 15:31:50 +08:00
毕竟写代码是一门 Art,就像画画,小学生想象力丰富一点也是可以理解的,同理;
icenine
2020-08-24 15:35:25 +08:00
这明摆着是 IDE 自动生成懒得删的,瞧给你们嘚瑟的,可算逮着个自己会的
1534853288
2020-08-24 15:39:49 +08:00
我们这边要求每一个变量和函数都要注释
wenlele
2020-08-24 15:42:43 +08:00
你可以做一个 code style rule 禁掉这种注释=。=
wty
2020-08-24 16:10:04 +08:00
之前有个小学弟,把我代码里面的变量名全丢翻译软件里面翻译成中文然后写在注释里面,,,,想半天不知道他为啥这么干,后来跟我说他看不懂英文🤣
a1562619919
2020-08-24 16:21:28 +08:00
如果没有形成注释规定,这样做“无可厚非”

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

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

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

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

© 2021 V2EX