为什么默认的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 ++编写的。
回答
因为它是默认文件模板,所以我们应该更改为组织的标准或者个人喜好。
我最好的猜测。