intellij-idea - 为什么默认的 IntelliJ 默认类 javadoc 注释使用非标准语法？

Question

为什么默认的 IntelliJ 默认类 javadoc 注释使用非标准语法？它可以用“@author jstauffer”创建一行，而不是用“用户：jstauffer”创建一行。它创建的其他行（日期和时间）可能没有可用的 javadoc 语法，但为什么不使用可用的 javadoc 语法呢？

这里有一个例子供参考：

/**
 * 由 IntelliJ IDEA 创建。
 * 用户： jstauffer
 * 日期：2007 年 11 月 13 日
 * 时间：上午 11:15:10
 * 要更改此模板，请使用 File | 设置 | 文件模板。
 */

score 54 · Accepted Answer

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

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

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

score 6 · Accepted Answer

在 Mac 上的 AndroidStuido 1.0.2 中

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

score 4 · Accepted Answer

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

我认为 IntelliJ 在默认情况下不使用 Javadoc 标记的原因是为了避免可能干扰开发商店中可能存在的任何编码/javadoc 标准。如果需要将默认值修改为更合适的值，用户应该很清楚。

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

score 3 · Accepted Answer

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

我最好的猜测。

score 1 · Accepted Answer

您显示的标题片段很可能比 javadoc 更早，并且只是从一些编码标准文档中借来的，可能是为 C++ 编写的。

5 回答 5