在Kotlin中生成方法或类评论

Question

我正在使用Android Studio 3.0.1。我可以点击fix doc comment以在Java中快速插入方法的评论，但在Kotlin中无效。我该如何解决？

Answer 1

kotlin，尤其是KDOC鼓励不同的文档样式。如本讨论中所述：

原因是我们发现，与传统的Javadoc样式相比，文档文本中的参数名称允许编写文档更简洁，更易于阅读，其中在单独的标签中记录了每个参数em>。因此，我们不使用参数名称生成模板，默认情况下。(D. Jemerov，Kotlin在行动作者中(

这是let的示例，它是标准库的一部分：

/**
 * Calls the specified function [block] with `this` value as its argument and returns its result.
 */
@kotlin.internal.InlineOnly
public inline fun <T, R> T.let(block: (T) -> R): R

Answer 2

当您在kdoc中键入@时，您会看到@param的自动完成，并且在@param之后，您会看到所有参数，当前您无法在一次单击中完成所有参数。

提及/** */评论在Kotlin中称为kdoc，不是javadoc。