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

时间:2020-03-05 18:53:39  来源:igfitidea点击:

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

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

/**
 * 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标签。

但是我们可以通过以下方式更改此行为:转到"文件->设置->文件模板",然后在"包含"标签中编辑"文件标题"条目。

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

回答

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

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

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

回答

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

回答

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

我最好的猜测。