IDEA 插件开发 plugin.xml 中 <depends config-file=".xml" optional="true"> 详解

在 IntelliJ IDEA 插件开发中，<depends> 元素用于声明插件依赖关系，而带有 config-file 和 optional 属性的特殊语法具有以下特性：

1. ‌基础依赖声明 ‌
   <depends>com.intellij.modules.java</depends> 表示插件强依赖于 Java 模块（IDEA 内置模块），若未安装该模块则插件无法加载。

2. ‌扩展属性解析‌

   • config-file="config.xml"：指定一个额外的配置文件路径（相对于插件根目录），该文件会在插件加载时被解析，通常用于定义模块特定的扩展配置14。
   • optional="true"：将依赖标记为可选，即使 com.intellij.modules.java 不存在，插件仍可加载（但需自行处理缺失功能逻辑）。

3. ‌典型使用场景 ‌

   这种配置常见于需要动态适配不同模块的场景，例如：

   • 为 Java 模块提供增强功能时，通过 doc-config.xml 定义额外的扩展点；
   • 插件核心功能不依赖 Java 模块，但需在 Java 环境中启用附加特性。

4. ‌配置文件示例结构 ‌
   doc-config.xml 可能包含 Java 模块相关的扩展声明，例如自定义代码检查或编辑器动作。

注意：实际效果需结合插件代码实现，optional 属性需在代码中通过 PluginManager.isPluginInstalled() 检测依赖状态。