myeclipse 可通过配置注释模板并启用生成选项,使 getter/setter 自动添加中文 javadoc 注释;主流版本(2023+)原生支持模板变量解析,旧版本需替换核心类或借助插件实现字段注释继承。

MyEclipse 默认生成的 getter/setter 方法不带中文注释,但通过两步操作就能让它们自动带上符合中文习惯、可读性强的 Javadoc 注释:先配置注释模板,再确保生成时启用注释选项。部分旧版本(如 MyEclipse 10.x)还需替换核心类文件才能支持字段级注释继承,但主流现代版本(2023+)已原生支持模板变量解析,无需手动改 jar。
配置 Getters/Setters 注释模板
这是最基础也最关键的一步。打开 Window → Preferences → Java → Code Style → Code Templates → Comments → Getters / Setters,分别编辑两个模板:
-
Getters 模板示例:
/** * 获取${bare_field_name}
* @return ${bare_field_name} ${bare_field_name} */ -
Setters 模板示例:
/** * 设置${bare_field_name}
* @param ${param} ${bare_field_name} */
其中 ${bare_field_name} 自动转为字段名(不含下划线或驼峰分隔),${param} 对应参数名。若希望显示字段上的已有注释(比如 /** 员工姓名 */ private String name;),需配合后续步骤。
生成时务必勾选“Generate method comments”
右键类编辑区 → Source → Generate Getters and Setters,在弹出窗口中:
Eclipse IDE 是一款由 Eclipse 基金会管理的开源、跨平台集成开发环境。其核心基于 Java 构建,通过强大的插件架构可扩展支持 C/C++、Python、PHP 等多种编程语言。它提供丰富的代码编辑、调试和重构工具,并紧密集成 Git、Maven 等现代开发工具链,是全球众多开发者首选的 Java 开发利器。
- 勾选要生成方法的字段
- 点击右下角 Configure… → 确保 Generate method comments 已打钩
- 访问修饰符(public/private)按需选择,所有字段统一生效
点 OK 后,方法上方就会自动生成对应中文注释,格式与模板完全一致。
让注释继承字段上的中文说明(进阶)
如果字段本身已有 Javadoc 注释(如 /** 用户邮箱地址 */ private String email;),想让 getter/setter 直接复用这句描述,标准 Eclipse/MyEclipse 不支持开箱即用。可行方案是:
- 使用插件增强(推荐):安装 AnyEdit Tools 或 CodeMix,部分版本支持从字段注释提取描述填入模板变量
- 手动替换核心类(仅限老版本):备份
org.eclipse.jdt.ui_*.jar,解压后替换GetterSetterUtil.class为支持${field_comment}变量的定制版,再重启 MyEclipse - 折中做法:在模板中写成
/** * ${bare_field_name}(请补充说明) */,生成后再批量查找替换,效率仍高于逐个手写
快捷键与验证技巧
常用操作可提速:
- 生成 getter/setter:光标置于类内 → Alt + Shift + S → R → 全选字段 → 勾选注释 → OK
- 快速格式化代码:生成后按 Ctrl + Shift + F,让注释对齐更清爽
- 验证是否生效:新建一个带中文字段注释的类,生成后检查方法上方是否有对应中文描述,无则回头确认模板保存和勾选状态










