本文详解如何在 eclipse rcp 应用中通过编程方式安全、可靠地修改“number of opened editors before closing”（即编辑器标签页自动关闭阈值）这一关键 ui 行为参数，并明确指出官方支持路径与内部 api 的风险边界。
本文详解如何在 eclipse rcp 应用中通过编程方式安全、可靠地修改“number of opened editors before closing”（即编辑器标签页自动关闭阈值）这一关键 ui 行为参数，并明确指出官方支持路径与内部 api 的风险边界。
在 Eclipse RCP 应用开发中，编辑器区域的标签页管理行为（如达到多少个打开的编辑器后开始自动关闭旧标签）由平台偏好设置控制。该设置在 UI 中显示为 Preferences → General → Editors → Number of opened editors before closing，其底层对应一个整型偏好项，但并非通过 org.eclipse.ui.editors 扩展点或 IWorkbenchPreferenceConstants.MAX_EDITORS_FROM_MODEL（该常量已在较新版本中移除）配置，也不属于插件自身的 IPreferenceStore。
正确的目标偏好项 ID 是 IPreferenceConstants.REUSE_EDITORS（注意：其语义为“是否复用编辑器”，但实际在 IDE 实现中，该值被重载用作最大编辑器数阈值——当设为 0 表示禁用自动关闭，设为 N > 0 则表示最多保留 N 个最近使用的编辑器标签，超出后自动关闭最旧的）。该偏好项归属于工作台核心插件 org.eclipse.ui.workbench，因此必须通过 WorkbenchPlugin.getDefault().getPreferenceStore() 获取并修改：
import org.eclipse.ui.internal.IPreferenceConstants;
import org.eclipse.ui.internal.WorkbenchPlugin;
// ✅ 正确写法：使用 WorkbenchPlugin 的 PreferenceStore
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 和 WorkbenchPlugin 均为 org.eclipse.ui.internal.* 包下的内部 API（internal），Eclipse 官方明确不保证其稳定性与向后兼容性。在生产环境或需长期维护的 RCP 产品中，应谨慎评估此方案。
- 该设置需在工作台初始化完成之后（例如在 WorkbenchWindowAdvisor.postWindowOpen() 或 IStartup 扩展点中）执行，否则可能因偏好存储未就绪而失效。
- 修改后不会立即刷新已打开的编辑器标签；新阈值将在后续编辑器打开/关闭操作中生效。
- 若需提供用户可配置的 UI，建议参考 IDEEditorsPreferencePage 的实现逻辑，但避免直接继承或调用其内部方法。
✅ 推荐替代方案（面向长期维护）：
若项目允许，更稳健的做法是通过 plugin_customization.ini 文件预设该值（适用于部署时静态配置）：
# plugin_customization.ini /org.eclipse.ui/REUSE_EDITORS=15
或引导用户在运行时通过标准首选项页面手动配置（IDEEditorsPreferencePage 已内置支持），而非绕过 UI 层硬编码修改内部偏好。
综上，虽然技术上可通过内部偏好存储动态修改编辑器阈值，但开发者应优先考虑声明式配置或标准 UI 交互路径，以保障应用的可维护性与 Eclipse 平台升级兼容性。
