如何自定义生成的 javadoc 存根？

Question

在 Netbeans 中，当您在方法上方键入 /** 时，它会生成一个 javadoc 存根：

/**
 * 
 * @param 
 * @return 
 */

如何自定义生成的文本？我想要一个自定义的 javadoc 存根，例如：

/**  Author = {author}
 *  
 * My custom text  
 * 
 * @param 
 * @return 
 */

注意：这是一个方法，而不是使用类模板的类。

搜索词： netbeans javadoc 模板存根自定义自动完成

Answer 1

这不会取代/** 的功能，但它会为您提供替代方案。

• 进入Tools, Options，
• 点击Edit, Code Templates标签，
• 从语言下拉菜单中，确保选择了 Java，
• 点击New，
• 输入您选择的缩写（我使用jdt 作为 javadoc 模板），
• 点击OK，
• 在扩展文本下，键入所需的 javadoc 注释。注意：一件烦人的事情是，你必须在带有单词的行的末尾有一个额外的输入，否则它不会将下一个单词移到下一行。

例如，如果你输入这个：

/**
 * @author
 * 
 * @param
 * @return
 */

它会输出这个：

/**
 * @author
 * 
 * @param @return
 */

但是如果你输入这个：

/**
 * @author
 * 
 * @param
 *
 * @return
 */

它会输出：

/**
 * @author
 * 
 * @param
 *
 * @return
 */

有点奇怪。无论如何，一旦你输入了，看看 Expand Template on: 按钮，看看它是否设置在 tab 或 enter 或其他什么地方。那部分是你的选择。但是，您要激活模板。点击OK。

在您的文档中，转到您要插入预格式化评论的位置，而不是输入 /**，而是输入 jdt，然后执行展开模板操作（制表符、回车等）的任何操作，您的评论就会出现.