搜不到ESLint或GitToolBox，主因是关键词错误（如输eslint-plugin而非ESLint）、未切换至Marketplace标签页、IDE版本与插件不匹配（需核对Versions页“Compatible with”字段），或旧版插件改名（如StringTools→String Manipulation）。
搜不到 ESLint 或 GitToolBox 怎么办
不是插件下架了，而是关键词或环境不匹配。直接搜 ESLint，别输 eslint-plugin（那是 npm 包名）；确认你当前打开的是 Marketplace 标签页，不是 Installed 或 Settings 其他子项。
- WebStorm 2026.1 用户搜不到某插件？去 JetBrains Marketplace 插件页点开「Versions」标签，看是否标注 “Compatible with 2026.1+” —— 不匹配的版本根本不会出现在搜索结果里
- 旧版叫
StringTools的插件，在 2025.3+ 版本中改名为String Manipulation，得按新名字搜 - 某些插件（如
Docker）在 Marketplace 搜索时需输入全称，输docker就行；但GitToolBox中间没有空格，输成git toolbox就找不到
离线安装插件总报 “Plugin is incompatible”
这不是 WebStorm 报错，是你没对上版本号。离线安装必须严格匹配 IDE 版本和插件构建号，且不能提前解压。
- 去插件 Marketplace 页面 → Versions 标签 → 找标着跟你 WebStorm 完全一致的版本（例如 WebStorm 2026.1 对应插件版本号是
2026.1.12345），下载 ZIP 或 JAR 文件 - Settings → Plugins → 右上角齿轮图标 →
Install Plugin from Disk…→ 选中你刚下载的.zip或.jar文件（注意：系统自带解压工具点开看过就废了，WebStorm 只认压缩包原文件） - 装完必须关掉 IDE 再重启，
Invalidate caches或Reload project都不触发插件加载逻辑
插件装上了但功能没反应
启用 ≠ 激活。很多插件只在满足特定项目上下文时才真正工作，空项目或配置缺失会导致功能静默失效。
-
ESLint插件要求项目根目录存在.eslintrc.js、.eslintrc.json，或package.json里有eslintConfig字段；否则连编辑器右下角的校验图标都不会显示 -
GitToolBox必须检测到.git/目录才启动分支提示、提交统计等功能；用git init初始化仓库后才能看到效果 - 快捷键冲突常见于
Ctrl+Alt+L（格式化），多个插件注册同一快捷键时，后安装的会覆盖前一个；去 Settings → Keymap 搜该组合键，看绑定是否被意外替换 - 检查 Plugins → Installed 页，插件名称旁复选框是否勾选 —— 禁用状态显示为灰色文字，容易被忽略
命令行安装插件失败的几个硬坑
命令行方式看似高效，但路径、权限、IDE 状态三者缺一不可，稍错就静默失败。
- 必须先退出 WebStorm，否则命令会被忽略（无报错、无日志、无反应）
- Windows 下进
WebStorm\bin\目录运行webstorm64.exe installPlugins <PluginID>；macOS 下用open -na "WebStorm.app" --args installPlugins <PluginID>；Linux 下用webstorm.sh installPlugins <PluginID> -
PluginID一定从 Marketplace 插件页「Additional information」栏复制，比如org.jetbrains.plugins.github，不是插件名也不是 URL 路径 - 若用 Toolbox App 管理 IDE，优先用它生成的 Shell 脚本执行命令，避免手动找 bin 目录出错
