WebStorm离线安装插件必须通过Settings→Plugins→齿轮图标→Install Plugin from Disk…路径，不可拖拽文件；需从Marketplace Versions页下载匹配当前版本（如2026.1）的.zip/.jar包，安装后仅在Installed页显示为Local类型，重启后验证功能。
WebStorm 里装插件不靠快捷键，Settings（或 macOS 的 Preferences）才是唯一入口——所有插件安装、启用、禁用、更新都必须走这个路径，没有快捷键能跳过它。
Plugins → Marketplace 是唯一可靠安装入口
别在主界面按 Ctrl+Shift+A 搜“install plugin”，也别试图拖 ZIP 文件进编辑区。正确路径是：File → Settings → Plugins（macOS 是 WebStorm → Preferences → Plugins），再切到 Marketplace 标签页。
- 搜索时输插件全名，比如
TONGYI Lingma，不是tongyi或lingma——少一个字母可能搜不到官方版本 - 确认开发者是
Alibaba Cloud（通义灵码）、JetBrains（ESLint、GitToolBox）等可信来源，避免安装仿冒插件 - 插件详情页右下角会标兼容的 WebStorm 版本范围，2026 年当前主流是
2024.3–2025.2，若你用的是2023.2，得手动去 Marketplace 网页找旧版下载
Install Plugin from Disk 用于离线/回滚场景
公司内网、CI 流水线、或想降级插件时，才需要从磁盘安装。注意：这不是“备用安装方式”，而是特定场景下的必要操作。
- 下载 ZIP 文件后，不要双击打开，也不要拖进 IDE 窗口——这会触发“打开文件”行为，不是安装
- 必须通过
Plugins页面右上角齿轮图标 →Install Plugin from Disk…导入 - 导入后插件类型显示为
Local，不会出现在Marketplace页，也不会自动检查更新 - 如果装完没反应，先看底部状态栏有没有对应图标（如通义灵码的鲸鱼图标），再查
Installed页是否被意外禁用
命令行 installPlugins 只适用于批量部署
日常开发根本用不上这条命令，它只适合 DevOps 脚本或企业统一部署。一旦路径或 ID 错，就会静默失败，毫无提示。
- 命令必须在 WebStorm
bin/目录下运行，不是任意路径；Windows 是webstorm64.exe installPlugins com.alibaba.tongyi.lingma，macOS/Linux 是./webstorm.sh installPlugins com.alibaba.tongyi.lingma -
com.alibaba.tongyi.lingma是精确 ID，大小写、点号、连字符一个都不能错，IDE 缓存损坏时还可能报Plugin failed to load - 执行前必须完全退出 WebStorm，否则会提示 “port in use” 或直接无响应
- 装完仍需手动重启 IDE，命令本身不触发重启
真正容易被忽略的是：插件生效 ≠ 功能可用。比如 ESLint 插件装完，但项目根目录没有 .eslintrc.js 或 package.json 里没声明 eslintConfig，右键菜单和校验提示照样不出现。功能依赖环境配置，不是装上就自动跑起来。
