注释写得太多了会挨打吗？

2018-09-25 17:26:16 +08:00
 fundebug

16147 次点击
所在节点    程序员
145 条回复
entimm
2018-09-25 21:01:34 +08:00
把代码写成白话文不是更好吗
Yuicon
2018-09-25 21:04:22 +08:00
这么一看 java 虽然啰嗦点 但是可以少写很多 ‘注释’
sonyxperia
2018-09-25 21:08:19 +08:00
我觉得挺好
lightening
2018-09-25 21:09:56 +08:00
信息太多会让真正重要的信息无法找到
wsxyeah
2018-09-25 21:17:32 +08:00
命名很重要，窃以为见名知意要比写一大堆冗余的注释要好得多
xuanbg
2018-09-25 21:23:01 +08:00
挺好的，排版再对齐一下就更好了。
oxoxoxox
2018-09-25 21:26:52 +08:00
这种注释挺好的 标准做法 直接就能导出成文档了 应该鼓励
乱写注释才会被人打
fundebug
2018-09-25 21:28:57 +08:00
@lightening 注释应该言简意赅！
framehouse
2018-09-25 22:13:26 +08:00
有点啰嗦，不过看十行弱智注释也好过看一行莫名其妙的代码
gbin
2018-09-25 22:20:58 +08:00
@sampeng 参数 option 本身就是一个对象
neilp
2018-09-25 22:31:15 +08:00
太闲 了
bfpiaoran
2018-09-25 22:37:16 +08:00
我咋觉得遇到这种开发就该嫁了呢
catror
2018-09-25 22:41:16 +08:00
写给别人使用的接口就应该写这样的注释，然而，你会发现调用接口的人还是会来问你 :|
PP
2018-09-25 22:41:37 +08:00
可以直接加薪。
lijun0926
2018-09-25 23:04:29 +08:00
挺规范
hellodigua
2018-09-25 23:05:50 +08:00
学习了……
hotsymbol
2018-09-25 23:07:56 +08:00
看的想死
imn1
2018-09-25 23:10:52 +08:00
挨打是小事……
nodin
2018-09-25 23:15:11 +08:00
简洁明了的注释没人不喜欢，外行人也能看明白这代码用来做什么的注释肯定是好注释。
jmc891205
2018-09-25 23:23:50 +08:00
時間久了發現實現和註釋不一樣了:(

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

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

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

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

© 2021 V2EX