离线更新 WebStorm 插件必须手动下载匹配版本的 zip/jar 包，通过 Settings → Plugins → 齿轮图标 → Install Plugin from Disk… 安装，IDE 会自动覆盖旧版并保留配置；需严格核对 Marketplace Versions 页中 “Compatible with” 字段与当前 WebStorm 完整版本号（如 2026.1）一致，安装后重启并检查是否禁用或缺失依赖。
离线更新 WebStorm 插件必须重装，没有“在线检查更新”路径
WebStorm 离线环境下，插件不会自动提示更新，也不会在 Plugins → Installed 页面显示「Update」按钮。所谓“更新”，实际就是卸载旧版 + 安装新版 zip/jar 包的组合操作——IDE 不提供增量补丁或后台静默替换机制。
常见误解是点齿轮图标后选 “Check for Updates”，但这在离线时直接灰显或报错 Connection refused；也有人试图在 Marketplace 标签页搜同名插件再点 Install，结果装上的是线上最新版（版本不匹配直接失败）。
- 必须提前从 JetBrains Marketplace 的
Versions页下载与当前 WebStorm 版本精确兼容的新包（如 WebStorm 2026.1 → 找Compatible with: 2026.1的那一版） - 安装前不用手动卸载：新包安装时会自动覆盖同 ID 插件，但旧配置（如快捷键、设置项）通常保留
- 如果新包装完功能异常，优先检查
Help → Show Log in Explorer中是否出现PluginException或ClassNotFoundException，大概率是依赖插件没启用或版本错配
怎么找对新版插件包？别只看主版本号
JetBrains Marketplace 默认只展示最新版，而你需要的是「Compatible with」列明确包含你当前 WebStorm 完整版本号（如 2026.1）的那一个版本。2026.x ≠ 2026.1，差一个小数点就无法加载。
操作路径：打开插件官网页 → 点右上角 Versions 标签 → 拉表逐行核对 Compatible with 列 → 找到匹配项后点 Download。若下载链接被拦截，可把 URL 中的 https:// 改成 http://（例如 http://plugins.jetbrains.com/plugin/9442-vue-js/versions/251.18547.123）。
- 从 GitHub Release 下载时，认准文件名含
plugin、dist或build字样（如vue-js-251.18547.123.zip），别下source.zip - 包名带
intellij或idea不影响使用，只要Compatible with写了 WebStorm 版本即可 - 预发布版（alpha/beta）慎选，除非你明确需要尝鲜功能且接受稳定性风险
安装入口点错=白忙活，必须走齿轮图标路径
离线安装唯一有效入口是 Settings → Plugins → 齿轮图标 → Install Plugin from Disk…。拖拽 zip 文件进主窗口、双击 zip、解压后选文件夹——全都不触发安装逻辑，只会打开文件或弹出报错。
点错入口是最常见的失败原因：比如误点 Marketplace 标签页搜索框旁的 + 号，它只会打开浏览器；或者在 Installed 标签页右键插件选 “Update”，这在离线时无响应。
- 插件包必须保持原始
.zip或.jar压缩格式，不能用系统解压工具提前解压 - 安装过程无进度条，选中文件后点
OK即提交，成功与否要等重启后验证 - 装完插件只出现在
Installed页，类型标注为Local，不会出现在 Marketplace 页
装完不生效？先查禁用状态和依赖链
重启 WebStorm 后功能没出现，别急着重装。多数失效不是包的问题，而是运行时条件不满足。
去 Plugins → Installed 页，鼠标悬停插件名，确认开关是否呈灰色（即被意外禁用）；再点插件右侧的 Additional Information，展开 Dependencies，检查是否漏装依赖插件（例如 Vuetify Support 依赖 Vue.js）。
- 某些插件生效还需项目级条件，比如 ESLint 插件需要项目根目录存在
.eslintrc.js或package.json中有eslintConfig - 命令行方式（
webstorm64.exe installPlugins <pluginid></pluginid>）仅适合批量部署，日常更新没必要用，且要求 IDE 完全退出、路径精准、ID 大小写严格匹配 - 真正容易被忽略的是：插件加载成功 ≠ 功能可用。比如通义灵码装完后底部状态栏没出现鲸鱼图标，大概率是插件 ID 冲突或 JVM 参数限制了类加载
