离线安装WebStorm插件唯一有效路径是Settings→Plugins→齿轮图标→Install Plugin from Disk…；必须下载与当前版本精确匹配的未解压.zip/.jar包，安装后仅在Installed页显示为Local类型，重启后验证功能。
离线安装 WebStorm 插件，唯一有效路径是 Settings → Plugins → 齿轮图标 → Install Plugin from Disk…；拖 ZIP 文件进主窗口、双击打开、提前解压——全都不触发安装逻辑，IDE 会当成普通文件处理。
必须用 Settings 里的齿轮入口，不能点 Marketplace 页的 + 号
很多人点开 Plugins 页面后，误以为左上角 Marketplace 标签页旁那个 + 是本地安装入口，其实它只会打开浏览器跳转到 Marketplace 搜索页。真正能读取本地文件的入口，只在 Plugins 页面右上角齿轮图标下拉菜单里，叫 Install Plugin from Disk…。点错入口，选再对的包也白搭。
插件包必须和 WebStorm 版本精确匹配（比如 2026.1 ≠ 2026.x）
从 JetBrains Marketplace 下载时，别只看插件主页显示的“Latest version”，得手动点开右上角的 Versions 标签页，逐个核对 Compatible with 列：必须包含你当前 WebStorm 的完整版本号（例如 2026.1），不能只写 2026.x 或 2026.*。常见错误包括：
- 下了 GitHub Release 里的
source.zip，实际要找的是带plugin、dist或构建编号的 artifact（如vue-js-251.18547.123.zip） - 包名含
intellij或idea就不敢装——只要Compatible with列写了 WebStorm 版本，就能用 - 企业防火墙拦截 HTTPS 下载时，把 URL 的
https://改成http://（例如http://plugins.jetbrains.com/plugin/9442-vue-js/versions/251.18547.123）
ZIP/JAR 必须保持原样，不能解压、不能重命名、不能拖进窗口
WebStorm 安装器只识别未解压的原始压缩包结构，系统解压工具提前解压后选文件夹，或重命名为 xxx.zip.bak，都会导致 Plugin is incompatible 报错。另外注意：
- 安装过程无进度条，选中文件点
OK后 IDE 不提示成功，必须重启后验证 - 装完不会出现在
Marketplace页，只在Installed页显示，类型标注为Local - 重启后没反应？先去
Installed页悬停插件名，确认开关没被意外禁用（灰色 = 已禁用）
装完不生效？优先查依赖和日志，别急着重装
很多“插件没用”问题其实不是安装失败，而是依赖缺失或类加载失败。建议按顺序排查：
- 打开插件右侧的
Additional Information，展开Dependencies，检查是否漏装依赖（例如Vuetify Support依赖Vue.js） - 执行
Help → Show Log in Explorer，搜索PluginException或ClassNotFoundException，日志里通常直接写出哪个类找不到、哪版不匹配 - 卸载前记下插件 ID（悬停可见），避免重装后配置丢失；离线环境重装成本高，一次查准比反复试更省时间
最常被忽略的一点：插件包本身没问题，但 WebStorm 启动时加载顺序或依赖链断裂，会导致功能图标不出现、快捷键无效、右键菜单不弹出——这些都不是“安装失败”，而是运行时上下文缺失，得靠日志定位具体类，不是换包就能解决的。
