全球编程论坛，代码注释狂魔怎么写比较合适？

senwzz

// 说明 if else 的注释
if (....) {
// 说明以下 判断块 的注释
// 说明第一句代码的注释（这里该怎么让块和第一句的注释有所区别，这样不是在一起了）
....巴拉巴拉
....巴拉巴拉
....巴拉巴拉
....巴拉巴拉
} else {
// 说明以下 内容块 的注释
....巴拉巴拉
....巴拉巴拉
....巴拉巴拉
....巴拉巴拉
}

野兔

最烦两件事：1.别人的代码不写注释；2.写注释。

未闻听心

正经人谁写注释？？？？？
尽量让一个方法只做一件事，尽量把方法名写清楚，方法名尽量不要简写，不要怕他名字长；
能用变量名，能用方法名说明代码功能的尽量不要写注释；
注释一般用于实在代码表达不清楚的地方。
注释太多等于无。

夕日

写这么多注释还不如把变量名起得有意义一点

chinayang

别用拼音的首字母组成变量名就好，这玩意一般人还真看不懂，哪怕全拼都行

wqz

注释写的比代码多
之前写过一个python程序  程序段82行 注释97行
这种把注释写成半个开发文档的情况利于后续开发以及他人接手

senwzz

野兔 发表于 2020-7-2 11:18
最烦两件事：1.别人的代码不写注释；2.写注释。

比起写文档说明还是好多了。。。

leven5

变量名别太**就行了...

victor_ada

去看阿里的代码规范

senwzz

极限挑战 发表于 2020-7-2 10:52
擦  光顾着看你头像去了

色即是空，空即使色

大杀器

senwzz 发表于 2020-7-2 10:53
如果写尾部只能写一行，多行就不行了

大致描述一下就好了，详细看代码啊， 自己写的还看不懂嘛。   
工作都在注释上了不然

senwzz

heihai 发表于 2020-7-2 10:41
虽然说清晰的注释很重要，但也没必要像这样搞吧

要写啊，一年后自己都看不懂自己当初是怎么个想法，注释为了自己快速回忆进入状态，防止越改越错