离线安装插件必须使用官方发布的 .zip 包而非 .jar 文件，因 IDEA 仅支持符合插件规范的 .zip 格式；需通过 Settings → Plugins → 齿轮图标 → Install Plugin from Disk... 直接选择 .zip 文件（不解压），并确保插件版本与 IDEA 构建号兼容，且在插件列表中手动启用。
离线安装插件必须用 .zip，不是 .jar
很多人卡在第一步：下载了 lombok-intellij-plugin-xxx.jar 直接双击或拖进 IDEA，结果提示“Invalid plugin archive”或“Plugin format is not supported”。这是因为 JetBrains 官方插件分发格式是 .zip（内部含 META-INF/plugin.xml 和类路径结构），而单独的 .jar 文件只是编译产物，不满足插件加载规范。
- 去 plugins.jetbrains.com 搜索插件 → 进入详情页 → 切换到
Versions标签 → 点击Download按钮（它下的是.zip） - 第三方插件如 Lombok，务必从其 GitHub Releases 页面下载带
-intellij-后缀的.zip包（例如lombok-intellij-plugin-2025.1.0-2024.3.zip），不是源码包或 Maven.jar - 若只拿到
.jar，不能硬装；可尝试用 7-Zip 手动打包成符合结构的.zip，但风险高、易失效，不推荐
Install Plugin from Disk 的真实触发路径
菜单入口藏得有点深，且不同版本 UI 有差异。最稳的方式不是靠记忆，而是按路径操作：
- 打开
File → Settings（Windows/Linux）或IntelliJ IDEA → Preferences（macOS） - 左侧导航选
Plugins，**别点右上角的“+”号**（那是在线搜索入口） - 点右上角齿轮图标
⚙️→ 选Install Plugin from Disk... - 弹出文件选择框后，**直接定位到你下载的
.zip文件，选中它，点 OK** —— 不要解压，不要进子目录
常见错误：在插件列表里右键 → “Install plugin from disk”，这个上下文菜单有时不响应；或误点 Browse repositories...，它会联网，离线环境直接卡住。
版本对不上？不是“装不了”，是“不加载”
IDEA 不会报错说“版本不兼容”，而是静默跳过。插件列表里看不到它，重启后也无反应。根本原因是插件 plugin.xml 中声明的 idea-version 范围与当前 IDEA 版本不匹配。
- 查自己 IDEA 版本：
Help → About→ 看 Build number（如233.14475.28），对应代号如2023.3或2024.2 - 查插件支持范围：打开下载的
.zip，解压查看META-INF/plugin.xml中的<idea-version since-build="..." until-build="..."></idea-version> - 典型坑：用 2024.3 版插件装在 2023.2 上 → 失败；但反过来（老插件装新 IDEA）常能运行，只是可能缺新功能
- 临时绕过检查（仅调试）：启动 IDEA 时加 JVM 参数
-Didea.plugin.host.version.check=false，但生产环境不建议
装完不生效？先看日志，再确认启用状态
插件出现在列表 ≠ 已启用。尤其某些插件（如 MyBatisCodeHelper）默认是禁用状态，需要手动勾选。
- 重启 IDEA 后，进
Settings → Plugins，在已安装列表中找到插件名，确认右侧开关是开启状态（蓝色） - 如果仍不工作，打开
Help → Show Log in Explorer，查最近日志里是否有PluginException或ClassNotFound - 部分插件依赖其他插件（如 Lombok 需要同时启用
Annotation Processing），需一并检查Settings → Build → Compiler → Annotation Processors - 极少数插件（如旧版
Clock Plugin）在新版 IDEA 中因 API 移除而彻底失效，此时只能换替代插件或降级 IDEA
真正麻烦的从来不是“怎么点”，而是版本链路断在哪一环：插件包格式、IDEA 构建号、依赖插件开关、甚至 JDK 版本（部分插件要求 JDK 17+）。离线环境下，每一步都得亲手验证，没法靠“重试”蒙混过关。
