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

senwzz

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

野兔

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

未闻听心

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

夕日

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

yrj

没必要过度注释

ZjuSa.pRo

空一行啊，或者直接注释在第一句后面

heihai

虽然说清晰的注释很重要，但也没必要像这样搞吧

allnetstore

你需要的不是注释，是中文编程

大杀器

你这也太多了，一般我就这么干

1. 
   
2. 
   
3. if (....) {                                  // XX判断开始    条件：xxx                     
   
4. ....巴拉巴拉
   
5. ....巴拉巴拉
   
6. ....巴拉巴拉
   
7. ....巴拉巴拉
   
8. } else {                                   //条件外执行XX操作            
   
9. ....巴拉巴拉
   
10. ....巴拉巴拉
    
11. ....巴拉巴拉
    
12. ....巴拉巴拉
    
13. }                                            // XX判断结束

复制代码

llyang

介个。。。。
'
#
rem
....
语言不一样，注释完全不同

Jay

注释多了, 严重影响我一目十行代码

senwzz

ZjuSa.pRo 发表于 2020-7-2 10:40
空一行啊，或者直接注释在第一句后面

空一行难看。。强迫症
写代码行尾会不产生很多修改的不方便，很早就放弃了
可能应该弄个[] 描述下会比较好