Eclipse中Alt-Shift-J自动注释仅生成空注释的问题求助

针对IntelliJ IDEA的修复步骤 #

• 打开File > Settings（Windows/Linux）或IntelliJ IDEA > Settings（Mac），搜索Live Templates
• 展开Java分组，找到名为doc的模板（这是Alt-Shift-J触发的默认模板）
• 修改模板内容为包含自定义变量的格式，示例：

  /**
   * $DESCRIPTION$
   * $TAGS$
   * @param $PARAMS$
   * @return $RETURN$
   * @throws $THROWS$
   */
  

• 点击模板下方的Edit variables按钮，为TAGS变量设置默认值（比如你需要的Title），或者将其类型设为Prompt user让每次生成时输入内容
• 确认模板的Applicable in范围勾选了Java: method，保存设置后重新测试

针对Eclipse的修复步骤 #

• 打开Window > Preferences，导航到Java > Code Style > Code Templates
• 展开Comments目录，选择Methods选项
• 点击Edit按钮修改模板，添加自定义标签行，示例：

  /**
   * ${tags}
   * @param ${param}
   * @return ${return_type}
   * @throws ${exception_type}
   */
  

• 保存设置后，重启Eclipse再测试注释生成功能

额外排查点 #

• 确保选中的是完整的方法签名，而非方法内的部分代码
• 暂时禁用第三方代码注释类插件，排查是否存在冲突
• 若模板修改后仍无效，可先重置为默认模板，再重新自定义配置

内容的提问来源于stack exchange，提问作者jonesy19