插件提示“incompatible with current ide version”的直接原因是plugin.xml中since-build/ until-build范围未覆盖ide当前build号（如233.14475.16），ide会硬性拦截加载；应通过help→about查准build号，在plugins.jetbrains.com匹配兼容版本，或手动修改plugin.xml后重打包安装。
插件提示“incompatible with current IDE version”怎么办
直接原因就是插件元信息里声明的支持版本范围，和你当前 IDEA 的 build number 对不上。IDEA 不会加载超出范围的插件，哪怕功能本身完全可用。这不是警告，是硬性拦截。
查当前 IDEA 版本号最准的方式是：打开 Help > About，看第二行末尾的 Build #，比如 IC-233.14475.16 —— 这个 233 就是主版本代号（对应 2023.3），不是显示的 “2023.3.4”。插件 plugin.xml 里的 idea-version since-build 和 until-build 必须覆盖这个数字。
- 去 plugins.jetbrains.com 搜索插件名，点进详情页，在 “Version History” 标签页里找带绿色勾号的版本，它标注了兼容的
Build范围 - 如果最新版不兼容，别急着降级 IDEA，先试试历史版本 —— 比如
RestfulTool 3.0.4支持232.*到233.*，而你用的是233.14475.16，就刚好匹配 - 别信插件页面写的 “Compatible with IntelliJ IDEA 2023.3”，这种描述常滞后；认准
Build号范围
手动修改 plugin.xml 强制启用插件
某些插件（如旧版 Lombok）没有及时更新，但代码本身没大问题。这时可以解压插件 jar，改 META-INF/plugin.xml 里两个关键字段：
since-build 设成比你当前 build 号小一点的值（比如你的是 233.14475，设成 232.0）；until-build 设成足够大的值（比如 299.999）。改完重新打包成 jar，再通过 Settings > Plugins > Install Plugin from Disk… 加载。
- 操作前备份原插件 jar，防止改错导致 IDEA 启动失败
- Windows 下用 7-Zip 直接打开 jar 文件修改；macOS/Linux 用
jar -xf解压，改完用jar -cfM重打包 - 改完必须重启 IDEA，且首次启动可能弹出 “Plugin was modified externally” 提示，点 OK 即可
插件功能正常但 API 扫描不到或报红
这通常不是版本问题，而是插件和项目环境没对齐。比如 RestfulTool 找不到 @RequestMapping，或 Lombok 注解下标红，根本原因在项目配置没被插件识别。
重点检查三处：
- 项目是否标记为正确模块类型：右键项目 →
Open Module Settings→ 确保Modules里有Web或Springfacet，否则 RestfulTool 不扫描 Java 类 -
Annotation Processors是否启用：进Settings > Build, Execution, Deployment > Compiler > Annotation Processors，勾选Enable annotation processing，否则 Lombok 无法生成字节码 - 项目 JDK 和 IDEA 运行 JDK 是否一致：两者都得是 JDK 11+（Lombok、RestfulTool 均不支持 JDK 8），且不能混用 JRE 和 JDK
插件安装后不显示图标或菜单项
常见于插件依赖未满足，或缓存污染。优先执行 File > Invalidate Caches and Restart… > Invalidate and Restart，这是解决 70% “看不见” 问题的最快路径。
如果无效，再排查：
- 插件是否真被启用：进
Settings > Plugins，搜索插件名，确认开关是 on，且状态栏没显示黄色感叹号 - 是否有同类插件冲突：比如同时装了
Postman Integration和RestfulTool，它们都注册 HTTP 请求入口，IDEA 可能只激活其中一个 - Linux/macOS 权限问题：插件目录
~/.local/share/JetBrains/IntelliJIdea<version>/plugins/</version>下文件是否可读写？尤其解压手动安装的插件时容易权限丢失
真正麻烦的不是版本号对不上，而是插件在后台悄悄失败却没报错 —— 比如 RestfulTool 初始化时因 OkHttp 版本冲突静默退出，界面一切正常，但 API 树就是空的。这时候得翻 Help > Show Log in Explorer，搜 RestfulTool 或 Lombok 关键字，才能看到真实异常堆栈。
