为何阿里规约在 Java 中不能行尾注释？你们有什么看法？

[legiorange]

[wenzhoou]

人家的家规，开心就好。

[shuizhengqi]

不规定的话，如果大家都在行首注释，你来一个行尾注释，那你这个注释到底是针对上面的还是下面的？除了你，谁能懂

[skiy]

难道我看代码得从下面开始看的吗？每个 IDE 编辑器打开时都是头部显示的。注释一目了然，你却还要别人拉到最底部看注释才懂此文件干嘛用的。拉到下面了，我肯定都瞄了一遍代码了。

[fan123199]

@shuizhengqi 没有行首注释啊。我猜是因为许多人其实是要对一段代码注释，但只注释到了首行行末，这样可能不利于理解。另外 ide 对行末的注释也不会生产文档。 但是，我要说的是，很多时候行末注释是有效提高理解效率，我觉得可以用。

[maichael]

没什么看法，代码规范这种东西大多数情况下都不是为了分对错，而是为了减少争议。

[fan123199]

@skiy 是行末，不是文件末。

[hand515]

格式化有对一行多少个字符规定

[chendy]

个人观点：因为非文档注释通常都是要说明一些特殊情况，所以最好出现在代码前，先知道要做什么再看到代码
另外行尾注释比较容易超出宽度限制

[legiorange]

@shuizhengqi 行首注释 意思是这样吗。。？
// base
var base = Base ；

[W1angMh]

@skiy 兄弟看清是行末注释

[W1angMh]

@legiorange 是的，某行代码或者某个代码块的注释写在该行的上方（代码块写在第一行的上方）

[qwerthhusn]

别人的家规，参考一下得了，至少我感觉 这个没必要。

还有阿里的 IDEA 代码检查插件，我感觉啥有用的东西都检查不出来，检查出来的都是一些不关痛痒的东西。。

不过 IDEA 自带的 Inspect Code 是真的流批，只要代码那块黄了，八成是有问题的或者可以优化的

[skiy]

行尾是指：

[legiorange]

@skiy String id = params.get("c_Id"); //班级 ID
类似这样。行尾行末是一个意思。

[skiy]

var abc = 1; // 这种行末注释对吧？

如果这种要求，我觉得没必要了。

有时要定义一堆初始值时，我就是

var abc = 1; // abc 的注释
var bcd = 2; // bcd 的注释

是

// abc 的注释
var abc = 1;

// bcd 的注释
var bcd = 2;

感觉这样挺影响阅读的

[darlinghsu]

@skiy #13
大概是

demo() { //这是 xxxxx

}

我的习惯是：

//这是 xxxx
demo() {

}

[yanguangs]

阿里家规罢了.

[oxoxoxox]

这和“缩进应该用四个 space、还是两个 space、还是一个 tab ”这种问题有什么区别？

[laoyur]

@skiy > 行尾是指：

？？承认一句看错了很难吗

[skiy]

@darlinghsu 如果是代码块，我习惯放在前面

// abc 的注释
abc () {

}

但是 if else 功能好难用。。。

// abc
if abc {

// else 这里放置注释，IDEA 不太方便
} else { // 有很多人是放在这里注释，感觉这种情况放在这里注释很方便

}