为什么默认的IntelliJ默认类javadoc注释使用非标准语法?

为什么默认的IntelliJ默认类javadoc注释使用非标准语法?

Why does the default IntelliJ default class javadoc comment use non-standard syntax?

为什么默认的IntelliJ默认类javadoc注释使用非标准语法? 代替使用" User:jstauffer"创建行,可以使用" @author jstauffer"创建行。 它创建的其他行(日期和时间)可能没有要使用的Javadoc语法,但是为什么不使用Javadoc语法(如果可用)?

供参考,下面是一个示例:

1
2
3
4
5
6
7
/**
 * Created by IntelliJ IDEA.
 * User: jstauffer
 * Date: Nov 13, 2007
 * Time: 11:15:10 AM
 * To change this template use File | Settings | File Templates.
 */

我不确定为什么Idea在默认情况下不使用@author标记。

但是您可以通过转到File -> Settings -> File Templates并在Includes选项卡中编辑File Header条目来更改此行为。

从IDEA 14开始,它是:File -> Settings -> Editor -> File and Code Templates -> Includes -> File Header


在Mac上的AndroidStuido 1.0.2中

进入首选项
然后在左跨度文件和代码模板
在右侧选择文件和代码模板之后,选择包括选项卡选择
文件头并更改文件头。


默认值是可读的,可用的,但不遵守或建议任何编码标准。

我认为IntelliJ在默认情况下不使用Javadoc标签的原因是,这样可以避免对开发商店中可能存在的任何编码/ javadoc标准的干扰。如果需要将默认值修改为更合适的内容,那么对于用户来说应该是显而易见的。

在我工作的地方,出于各种原因,不建议使用作者标签。


因为它是默认文件模板,所以您应该更改为组织的标准或个人喜好。

我最好的猜测。


您显示的标头代码段可能比javadoc旧,并且是从某些编码标准文档中借用的,该文档可能是为C ++编写的。


推荐阅读