本文详解在 eclipse rcp 应用中通过编程方式调整“number of opened editors before closing”（即编辑器自动关闭阈值）的正确方法，明确指出官方支持路径、内部 api 的风险，并提供可落地的替代方案。
本文详解在 eclipse rcp 应用中通过编程方式调整“number of opened editors before closing”（即编辑器自动关闭阈值）的正确方法，明确指出官方支持路径、内部 api 的风险，并提供可落地的替代方案。
在 Eclipse RCP 应用开发中，用户常希望动态控制编辑器标签页（Editor Tabs）的数量上限——当打开的编辑器超过设定值时，系统将自动关闭最久未使用的编辑器以释放资源。该设置在 UI 中称为 “Number of opened editors before closing”，对应偏好设置项的键名为 REUSE_EDITORS，其真实含义是：当已打开编辑器数 ≥ 此值时，新打开的编辑器将复用已有标签页（即触发关闭策略），而非无限制新增。
⚠️ 重要前提：此参数并非控制“最多允许打开多少个编辑器”，而是决定何时启用编辑器复用/关闭逻辑的阈值。它默认值为 10，可在 Preferences > General > Editors 中手动配置。
✅ 正确的设置方式（推荐）
该偏好项属于工作台（Workbench）级全局设置，必须通过 WorkbenchPlugin.getDefault().getPreferenceStore() 设置，而非普通插件的 getPreferenceStore()：
import org.eclipse.ui.internal.IPreferenceConstants;
import org.eclipse.ui.internal.WorkbenchPlugin;
// ✅ 正确：使用 WorkbenchPlugin 的 preference store
IPreferenceStore workbenchPrefs = WorkbenchPlugin.getDefault().getPreferenceStore();
workbenchPrefs.setValue(IPreferenceConstants.REUSE_EDITORS, 15); // 设为15
// 确保持久化保存
if (workbenchPrefs instanceof IPersistentPreferenceStore) {
try {
((IPersistentPreferenceStore) workbenchPrefs).save();
} catch (IOException e) {
Activator.logError("Failed to save editor reuse preference", e);
}
}? 补充说明：IPreferenceConstants.REUSE_EDITORS 是字符串常量 "reuseEditors"（注意大小写），定义于 org.eclipse.ui.internal.IPreferenceConstants。其值类型为 int，代表触发复用策略的编辑器数量阈值。
⚠️ 关键注意事项
内部 API 风险：org.eclipse.ui.internal.* 包下的类（如 IPreferenceConstants、WorkbenchPlugin）属于 Eclipse 非公开内部实现，不在 API 兼容性保证范围内。Eclipse 官方文档明确建议避免直接依赖内部包（Eclipse API Rules of Engagement）。升级 Eclipse 版本时可能失效或引发 NoClassDefFoundError。
-
❌ 错误示例解析：
// ❌ 错误：使用插件自身的 preference store，对工作台行为无效 IPreferenceStore prefs = getPreferenceStore(); prefs.setValue("org.eclipse.editorss.maxEditorTabs", 15); // 键名错误 + 存储位置错误- org.eclipse.editorss.maxEditorTabs 并非有效键名（拼写错误且不存在）；
- 插件级 IPreferenceStore 无法影响工作台核心编辑器管理逻辑。
-
? 替代方案（面向未来兼容性）： 若需长期稳定支持，建议采用 声明式扩展点配置 + 用户引导 方式：
- 在 plugin.xml 中通过 org.eclipse.ui.preferencePages 扩展自定义偏好页，封装该设置；
- 或在应用启动时（如 WorkbenchAdvisor#preStartup()）检查并提示用户手动配置（Window > Preferences > General > Editors）；
- 对于企业级 RCP 产品，可考虑通过 .product 文件或启动参数预置 config.ini，但注意该值仍需由用户最终确认。
✅ 验证设置是否生效
修改后需重启工作台（或至少重置编辑器区域）才能生效。可通过以下方式验证：
- 打开超过设定数量（如15个）的不同文件；
- 观察第16个文件是否复用已有标签页（而非新增），且最早打开的编辑器被关闭；
- 或在调试模式下读取值：
int current = WorkbenchPlugin.getDefault().getPreferenceStore() .getInt(IPreferenceConstants.REUSE_EDITORS); System.out.println("Current REUSE_EDITORS: " + current); // 应输出15
总结
| 项目 | 说明 |
|---|---|
| 正确键名 | IPreferenceConstants.REUSE_EDITORS（值为 int） |
| 正确存储位置 | WorkbenchPlugin.getDefault().getPreferenceStore() |
| 是否推荐生产使用 | ⚠️ 仅限短期适配；长期应规避内部 API，转向用户配置引导或产品级预设 |
| Eclipse 版本兼容性 | 适用于 Eclipse 4.5+（Luna 及以后），但内部类路径可能随版本微调 |
掌握这一机制，有助于提升 RCP 应用的资源管理智能性与用户体验一致性。务必权衡灵活性与稳定性，在架构设计初期即规划好偏好设置的治理策略。
