V2EX = way to explore
V2EX 是一个关于分享和探索的地方
Sign Up Now
For Existing Member Sign In
• 请不要在回答技术问题时复制粘贴 AI 生成的内容
This topic created in 2771 days ago, the information mentioned may be changed or developed.
 |
1
whypool Sep 25, 2018
会，把注释当文档了
|
 |
2
pain400 Sep 25, 2018
挺好的
|
 |
3
orange1818 Sep 25, 2018
我已经备好手枪了
|
 |
4
easylee Sep 25, 2018 via Android
一份经久不衰的代码，注释量与代码量的比应该至少为 2:1。
|
 |
5
fundebug OP  1
@orange1818 《刑法》第一百二十八条第一款的罪名为非法持有、私藏枪支、弹药罪。该款规定：违反枪支管理规定，非法持有、私藏枪支、弹药的，处三年以下有期徒刑、拘役或者管制；情节严重的，处三年以上七年以下有期徒刑。
|
 |
6
smilepig Sep 25, 2018
详细点是蛮好的。。。
|
 |
7
wupher Sep 25, 2018 7
别的都还好，console.warn 我笑了
|
 |
8
Mariano Sep 25, 2018
随便看了一眼，密密麻麻的字看的我头疼
|
 |
9
yulitian888 Sep 25, 2018 2
不写注释才会被打呢
比如下面这样的： /* +---------------+ | | | 本数据库操作类 | | | +--+--+---------+ | ^ v | | +-----+---------+ | | | 数据库 | | | | | +---------------+ */ |
 |
10
ranoff Sep 25, 2018
个人觉得的有点多
|
 |
11
zhangjiabin1010 Sep 25, 2018
喜闻乐见啊，多写点注释，方便你我他
|
 |
12
yangxiongguo Sep 25, 2018
导出一下就是文档了啊
|
 |
13
devtk Sep 25, 2018
写多了我不知道，写少了可能会被同事强杀
|
 |
14
keinx Sep 25, 2018 9
有个同事写的注释特别有意思，注释里面带了很多段子，有时候找 BUG 找的心烦，看到他的诡异注释还是挺不错的。
|
 |
15
depress Sep 25, 2018 5
我要是接手一个项目注释这么详细，我会请那个人吃顿饭，而且这个注释好在是在代码块外，如果是代码中，注释比代码还多，影响阅读代码那体验就很糟了。
|
 |
16
mztql Sep 25, 2018
规规整整的多好啊
|
 |
17
janxin Sep 25, 2018 1
没有 fuck，表明这段注释和代码是一个人写的 XD
|
 |
18
HuHui Sep 25, 2018 via Android
工作严重不饱和
|
 |
19
SamsonWang Sep 25, 2018
注释详细点挺好的
|
 |
21
zhangyichent Sep 25, 2018
整整齐齐的没人不喜欢，怕的是乱七八糟不知所谓的注释。。。
|
 |
22
endlessing Sep 25, 2018 1
注释不嫌多，怕的是啰嗦表述不清的
|
 |
23
zwwhdls Sep 25, 2018
@yulitian888 写了注释，跟代码不一样才会被打呢
|
 |
25
sampeng Sep 25, 2018 via iPhone
这么多参数。提一个 obj 封装一下可好…
|
 |
26
AV1 Sep 25, 2018 via Android 1
注释跟代码不一致，误导读者的，才会被打。
|
 |
27
zjp Sep 25, 2018 via Android
mockio 推崇注释即文档，异常信息还带正确示范
|
 |
28
anyele Sep 25, 2018 via Android
挺好的，
|
 |
29
moresteam Sep 25, 2018 via Android
0 注释的路过
|
 |
30
hheedat Sep 25, 2018
我觉得还行
|
 |
31
zwh2698 Sep 25, 2018 via Android
有枪🔫
|
 |
32
firenine Sep 25, 2018
这就体现 ts 的好处了，不用写这种注释
|
 |
33
way2create Sep 25, 2018
想起了上次那个画注释的帖子
|
 |
34
cjpjxjx Sep 25, 2018 via iPhone 2
这是前人栽树后人乘凉，比前人挖坑后人骂娘好多了
|
 |
35
tangweihua163 Sep 25, 2018
参数这么多…就不是注释的问题了…
|
 |
36
kerr92 Sep 25, 2018
像 20 楼说的，string/boolean/number 一般首字母小写，optional 的属性一般用中括号括起来。
|
 |
37
fademeter Sep 25, 2018 via Android
至少不会枪毙。
|
 |
38
zcjfesky Sep 25, 2018 via Android
当你接盘别人的项目的时候就知道这种耐心注释的选手简直就是天使…
|
 |
39
zhzer Sep 25, 2018
实在看不下去，可以让 ide 隐藏注释嘛
|
 |
40
flight2006 Sep 25, 2018
注释是好习惯，这个注释明显啰嗦了，‘一般 xxx ’后面的都可以省略，说了等于白说
|
 |
41
entimm Sep 25, 2018 via Android
把代码写成白话文不是更好吗
|
 |
42
Yuicon Sep 25, 2018
这么一看 java 虽然啰嗦点 但是可以少写很多 ‘注释’
|
 |
43
sonyxperia Sep 25, 2018
我觉得挺好
|
 |
44
lightening Sep 25, 2018 1
信息太多会让真正重要的信息无法找到
|
 |
45
wsxyeah Sep 25, 2018
命名很重要，窃以为见名知意要比写一大堆冗余的注释要好得多
|
 |
46
xuanbg Sep 25, 2018
挺好的，排版再对齐一下就更好了。
|
 |
47
oxoxoxox Sep 25, 2018 via Android
这种注释挺好的 标准做法 直接就能导出成文档了 应该鼓励
乱写注释才会被人打 |
|
48
fundebug OP @lightening 注释应该言简意赅！
|
 |
49
framehouse Sep 25, 2018 via iPhone
有点啰嗦，不过看十行弱智注释也好过看一行莫名其妙的代码
|
 |
51
neilp Sep 25, 2018
太闲 了
|
 |
52
bfpiaoran Sep 25, 2018
我咋觉得遇到这种开发就该嫁了呢
|
 |
53
catror Sep 25, 2018 via Android
写给别人使用的接口就应该写这样的注释，然而，你会发现调用接口的人还是会来问你 :|
|
 |
54
PP Sep 25, 2018
可以直接加薪。
|
 |
55
lijun0926 Sep 25, 2018 via iPhone
挺规范
|
 |
56
hellodigua Sep 25, 2018
学习了……
|
 |
57
hotsymbol Sep 25, 2018
看的想死
|
 |
58
imn1 Sep 25, 2018
挨打是小事……
|
 |
59
nodin Sep 25, 2018 via Android
简洁明了的注释没人不喜欢，外行人也能看明白这代码用来做什么的注释肯定是好注释。
|
 |
60
jmc891205 Sep 25, 2018 2
時間久了發現實現和註釋不一樣了:(
|
 |
61
fyibmsd Sep 25, 2018
你已经是个死人了
|
 |
62
SoulGem Sep 25, 2018 via iPhone
有点多说实话，这种 option 的注释写成文档会好一点。
|
 |
63
scys Sep 25, 2018
不要对一个参数写三行注释就行。
一页纸有 80%都是注释的代码，我看不下去。 |
 |
64
northernlights Sep 26, 2018 via Android
这是在写代码还是在写注释呢？垃圾代码写的注释再多也是垃圾代码，好代码不写注释也能让人一眼明白作者的思路。
|
 |
65
looseChen Sep 26, 2018
@northernlights 你能够一眼分辨出别人拉出来的屎？ 抱歉 话有点糙
|
 |
66
kslr Sep 26, 2018 via Android
我只会写思路和需要注意的部分
|
 |
67
RockShake Sep 26, 2018
注释可以直接生成文档的，你这样省了写文档的工作，不是挺好的么，Java 代码大部分文档不都这样生成的么，一堆人连编程规范都没读过吧。
|
 |
68
Howlaind Sep 26, 2018 via Android
干脆搞文学式编程得了
|
 |
69
bk201 Sep 26, 2018
维护起来相当麻烦,注释不应该面面俱到,应该关注重点.
|
 |
70
Lawlieti Sep 26, 2018
出来挨打
|
 |
71
MaxTan Sep 26, 2018
文档注释写再多都不怕。
a = 1; //给变量 a 赋值 这种直接打死 |
 |
72
allgy Sep 26, 2018
代码不够注释凑
|
 |
73
aaronysj Sep 26, 2018
参数是不是有点多
|
 |
74
wqzjk393 Sep 26, 2018 1
flask 源码了解下。。满屏幕的注释
|
 |
75
psklf Sep 26, 2018
我推荐多写注释，越详细越好。
|
 |
76
zhaogaz Sep 26, 2018
最好写成类似 javadoc 的那种，能直接生成文档。
其他的注释只保留极少部分 必要的就够了。 能做到以上 2 条的，基本是很优秀了。 |
 |
77
kingwl Sep 26, 2018 2
 |
 |
78
gesse Sep 26, 2018
下注释的习惯是好的， 不过这个代码能力有待商榷
|
 |
79
TomatoYuyuko Sep 26, 2018
同步 xhr 要被封杀么，哪里的消息
|
|
80
fundebug OP |
 |
81
ben1024 Sep 26, 2018
不推荐写注释，写注释是因为看代码不知道在做什么
|
 |
82
4everYang Sep 26, 2018
如果注释跟代码是一致的请他吃饭啊
|
 |
83
Linxing Sep 26, 2018
你敢不写试试？
|
 |
84
Edwards Sep 26, 2018
接受代码写得不好，但是不接受文档写的不好的，同理注释。
|
 |
85
NicholasYX Sep 26, 2018
一打眼就能看明白的没有必要写注释吧……
|
 |
86
xpresslink Sep 26, 2018
@fundebug
python 有一个专门生成文档的工具叫 sphinx，自己从代码中抽取注释生成结构化的 HTML 文档。 flask 的文档就是这么生成的。 好处是文档和代码是在一起的便于维护更新，每个人在代码里写自己的文档就好了。 最后只要生成一下就是最新的文档了，不用费力有专人去维护文档的一致性。 |
 |
87
q397064399 Sep 26, 2018
@fundebug #80 Python 没有注释 就没法合作了，这种动态语言 是真的令人难受
|
 |
88
brondogk886 Sep 26, 2018
这么全面的注释，不维护的话估计会被人打死
|
 |
89
xxl11231220 Sep 26, 2018
求之不得。表示嫌弃不写少些注释的
|
 |
90
mN71eOOprFyMsnPx Sep 26, 2018
代码应该做到自解释，你这样如果精力不够时，很容易出现注释和代码不同步，最终更加误导人。
|
 |
91
junbaor Sep 26, 2018
看起来这是个稍微底层的方法，这注释写的，完美~
|
|
92
northernlights Sep 26, 2018
@looseChen 我可没这本事，看来你经验丰富，你自己去吃吧。
|
 |
93
tiedan Sep 26, 2018
待过一家公司都不让写注释
|
 |
94
noNOno Sep 26, 2018
还是蛮好的
|
 |
95
ioth Sep 26, 2018
我会比较尊重这样的孩子。
|
 |
96
Mavious Sep 26, 2018
作为新手，最喜欢注释多多的代码了，每一行的功能都能靠注释看懂。
多多益善。 |
 |
97
ljspython Sep 26, 2018
注释永远不嫌多
|
 |
98
nomemo Sep 26, 2018
挺不错的，就是要持续维护
|
 |
99
AllenW Sep 26, 2018
这注释 厉害了
|
 |
100
sorra Sep 26, 2018
写错了才挨打
|
Select Language