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

[wuzhouhui]

例如声明变量和函数之前, 都要写一行注释

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

大家都是成年人, 哪有人不知道这是在声明, 至于写个注释吗? 放锁写个注释, 解锁再写个注释. 都三十好几的人了, 也不看看其他人是怎么写代码的, 都说了不要写多余的注释, 还不肯改

[constexpr]

强迫症吧

[kaiki]

真没必要拿出来说吧，愿意把注释写成说明书的人真不多了。

[democracier]

多了嫌冗余，少了嫌不清晰 真难伺候

[inwar]

ide 自动生成的吧

[chinvo]

这种就明显是“没意义的注释”

注释应该是对难懂逻辑的说明

[qsnow6]

愿意写就算及格了，至于写的是否足够简洁、易懂，要经过长期刻意练习才能做到。

[Jooooooooo]

有注释总是比没有好

[Procumbens]

https://www.reddit.com/r/ProgrammerHumor/comments/i4v6b2/comments/
莫名想到了之前 Reddit 看到的 ProgrammerHumor 里的一则帖子 hhh

[leafre]

不写可以了吧

[finab]

我的配色注释是灰色，代码颜色是亮色系。
我阅读代码时基本感觉不到注释的存在，写啥都行，推荐试试

[Vegetable]

为了注释而注释，脑子不清楚的表现。

[nicevar]

如果有 sonar 检查，这样是很正常的操作

[CEBBCAT]

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

从节点的选择中，确实能感受得到楼主对真理的追求

[anguiao]

感觉我遇到的同事，大部分都是以下两种：
1.无用注释一堆，代码该看不懂的还是看不懂；
2.基本上没几句注释，但代码条理还算清晰，耐心看还算能看懂。
代码写得好、注释又清晰的，是真的少，可能我身边的人都太菜了吧。

[wangzp0303]

才知道还有个“签证”区，话说代码相关的讨论为啥放“签证”区

[rouzip]

每个人状态不同，能力不同对于同段代码的理解也不同，需要看懂的时间也不同。注释不仅仅是规范化输入输出，更是清晰地告诉后来人，这个函数是什么，预期结果如何等等，让后人更加快速地了解这个函数，如果每个人都是 super star 级别的，全程跟项目，注释作用可能不明显，但是对于新人或者刚接触某个大型工程，可以让别人更好上手，省去大量时间看代码，跳逻辑。刚入行的实习新人，欢迎大家指正。

[louishwh]

总比一行不写的强，有的不加注释自己写的都看不懂

[laike9m]

不要光说，代码放出来看一下就知道多不多余了。一般而言如果确实只写了你说的这几个字，那确实多余。

[lithbitren]

声明变量是挺多余的

声明 XX 变量有时候还是需要，光靠变量名很多时候不能一眼推断出是干啥的变量

[lzlee]

所以这个人代码质量怎么样
他的注释影到底影响了什么
你给他提了明确的文档标准吗