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

时间:2008-09-15 15:07:51

标签: intellij-idea javadoc

为什么默认的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.
 */

5 个答案:

答案 0 :(得分:52)

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

但您可以转到File -> Settings -> File Templates并修改File Header标签中的Includes条目来更改此行为。

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

答案 1 :(得分:6)

Mac上的AndroidStuido 1.0.2

进入偏好设置 然后在左侧跨度文件和代码模板 在右侧选择文件和代码模板后,选择包含选项卡 文件标题并更改文件标题。

答案 2 :(得分:4)

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

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

在我工作的地方,由于种种原因,不鼓励使用作者标签。

答案 3 :(得分:3)

因为它是一个默认的文件模板,您应该根据组织的标准或您的喜好进行更改。

我最好的猜测。

答案 4 :(得分:1)

您显示的标题摘要可能比javadoc旧,只是从一些编码标准文档中借用,可能是为C ++编写的。