如何在IntelliJ IDEA中禁用JavaDoc的格式化

Question

我希望使用JavaDoc的样式：

/**
 * Description.
 *
 * @param param1     parameter description
 * @param param2     parameter description
 * @return           return description.
 * @throws exception exception description.
 */

正如您所看到的，我想使用对齐方式将参数，返回值和异常的描述向右对齐。

这种风格在http://www.oracle.com/technetwork/articles/java/index-137868.html中使用。

因此，我的问题是：我如何在IDEA 2016.x.x中配置此样式？或者，如果可能的话，如何禁用javaDoc的格式化而不使用特定的注释//@formatter:off和//@formatter:on？

当然，这不是一个严重或关键的问题，但我很感兴趣，因为开发人员不能按照官方文档自由设置样式是一种不好的情况。我相信我是错误的）

附：我已经尝试过在文件->设置->编辑器->代码风格->Java->JavaDoc中关闭启用JavaDoc格式（并尝试在该部分的所有设置中进行调整）。但我的JavaDoc对齐会在Ctrl-Alt-L后重置。

谢谢反馈！

- Alexey Nikitenko

---

我知道这不完全符合你的情况，但如果不是@param等，则可以使用html <pre></pre>标签。否则，您可能需要构建一个插件来指定该格式。 - Alessandro Scarlatti

将“_文件->设置->编辑器->代码样式->Java->JavaDoc，启用JavaDoc格式化_”设置为关闭对我很有效。我正在使用2016.1.2版本。 - eztam

Aleksey，你解决这个问题了吗？我也在尝试类似的事情，但即使关闭设置，它仍然为我生成Javadoc模板。 - Ungeheuer

Answer 1

"对齐参数描述"设置难道不会自动完成吗？ "

- Andrew Dant

Answer 2

IntelliJ有三个插件可能会有所帮助：

• 自动对齐
• 制表符
• 字符串操作

对我来说，最后一个似乎最适合。当我格式化文本时，我选择要格式化的文本部分，右键单击->字符串操作->对齐->对齐到列。 在这里，您需要尝试一下设置。它对我有效。

请参见屏幕截图： 我添加了一个空格（图像中的蓝色标记）作为分隔符；选择了一个javadoc注释并使用了上述函数。它有效。

- Walter Kuhn