概览

OpenIDEA 插件可以为 IDE 增加命令、编辑器功能、工具窗口、主题、图标和语言。插件就是一个带 plugin.toml 清单（manifest）的文件夹；如果包含代码，代码是一个运行在沙箱里的 WebAssembly 组件，只能做用户允许的事。

​

插件能做什么

• 添加命令。命令就是 IDE 操作：可以在 查找操作 和 随处搜索 中找到、绑定快捷键，也可以放进菜单、主工具栏和状态栏。
• 读写项目文件和当前编辑器，响应工作台事件（文件打开或保存、VCS 变化、执行了某个操作），并以带进度的后台任务运行工作。
• 为任意语言提供编辑器功能：补全、行内补全、快速修复、导航、悬停、内嵌提示、语义高亮、输入时诊断、格式化、代码透镜、装订区标记等。
• 显示工具窗口和自定义编辑器，可以是声明式的（树、列表、表单、表格），也可以是沙箱中的网页。
• 提供运行配置、测试结果解析器和运行目标、数据库数据源，以及给内置 MCP 服务器用的 MCP 工具。
• 调用 Web 服务、把密钥存进系统钥匙串、在自己的存储里保存数据、运行用户批准过的程序。
• 提供设置页、文件模板、代码片段、主题、文件图标主题和语言。

​

两种插件

插件一启用，声明的贡献就生效，不需要先加载代码：命令出现在 查找操作 里、主题可以应用、设置页已经存在。代码只在第一次需要时才加载（执行了它的命令、打开了它声明的语言的文件等），空闲 5 分钟后再卸载。 代码插件是面向 wit/ 中 plugin world 的 WebAssembly 组件。官方支持用 Rust SDK（sdk/rust/openidea-plugin）编写；任何有组件模型工具链的语言（componentize-py、jco componentize、TinyGo）也都可以面向同一个 world。

​

API 版本

在清单里用 engines.openidea 声明插件需要的 API，例如 engines.openidea = "^1.4"。

​

插件从哪里来

• 插件市场： 设置 › 插件 › 可用 列出官方插件和社区登记仓库中的社区插件。见 发布到市场。
• 磁盘： 在 设置 › 插件 的齿轮菜单中选择 从磁盘安装插件…（文件夹）或 从插件包文件安装…（.oiplugin 或 .zip）。
• 链接的文件夹： openidea-plugin link 让 IDE 直接加载你正在开发的文件夹，无需安装。
• 项目插件： 放在 <project>/.openidea/plugins/<name>/ 下的插件包，只在受信任的项目中、且你批准其权限后才会加载。

​

下一步

最完整、最权威的指南是仓库里的 plugins/README.md。