Eclipse 2025-06版本对Java 21记录（Record）的Javadoc生成是否仍不完整？

你观察得完全没错！在Eclipse 2025-06搭配Java 21时，Record的Javadoc自动补全确实只会生成空的/** */块，不会自动为每个成员参数添加@param标签——这真不是你漏了什么设置，而是当前版本Eclipse JDT（Java开发工具）的一个已知限制。

其实从Java 16引入Record特性开始，Eclipse对它的Javadoc模板支持就一直有点滞后，虽然核心的代码补全、编译功能都跟上了，但自动生成参数级Javadoc的功能还没完全适配到位，目前属于官方待优化的功能点。

给你两个实用的临时解决办法：

• 手动快速补全：在空的Javadoc块里输入@param，Eclipse会自动弹出参数名的提示，按回车就能快速补全单个参数的标签，多操作几次虽然麻烦，但比纯手动输入快很多。
• 自定义Javadoc模板：你可以自己修改Eclipse的模板来实现自动生成。具体路径是：Window > Preferences > Java > Code Style > Code Templates > Comments > Types，找到对应Record的模板（如果没有就编辑通用的Type模板），把模板内容改成包含${@param}变量的格式，比如：

  /**
   * ${summary}
   ${@param}
   */
  

  保存后，下次再在Record上方输入/**，就会自动生成所有参数的@param标签了。

目前这个问题在Eclipse的官方bug跟踪系统里已经有相关记录，开发团队正在评估优先级，后续版本应该会逐步修复。

内容来源于stack exchange