WebStorm安装插件核心路径是Marketplace在线搜索安装或Install Plugin from Disk离线导入；搜不到ESLint等插件主因是关键词错误（如输eslint-plugin）、IDE版本不匹配或未切至Marketplace页；离线安装须下载对应版本插件包，通过齿轮菜单导入，且必须重启生效。
WebStorm 安装第三方插件，核心就两条路：在线搜装（推荐）或离线导入（必须）——没有“拖文件进窗口”“双击安装包”这种操作，那样根本不会触发安装逻辑。
从 Marketplace 搜索安装插件时，为什么搜不到 ESLint 或 GitToolBox？
不是插件下架了，而是你输错了关键词或当前 IDE 版本不匹配：
- 搜索框里输
ESLint，别输eslint-plugin（那是 npm 包名，不是插件名） - 如果你用的是 WebStorm 2021.3，但插件页面标注“Compatible with 2023.2+”，那它就不会出现在搜索结果里
- 某些插件（如
String Manipulation）在旧版中叫StringTools，得按老名字搜 - 确认已切换到
Marketplace标签页，不是Installed或Settings其他子项
离线安装插件失败，常见报错是 “Plugin is incompatible” 或直接无反应
离线安装不是把 .jar 或 .zip 往 WebStorm 窗口一拖就完事。正确路径是：
- 先去 JetBrains 插件市场对应插件页，点开「Versions」标签，下载与你 WebStorm 版本严格匹配的包（例如 WebStorm 2026.1 对应插件版本列标着 2026.1）
- 打开
Settings → Plugins，点右上角齿轮图标 →Install Plugin from Disk…，选中你下载的文件 - 别用系统自带解压工具提前解压
.zip——WebStorm 只认压缩包原文件，解压后反而报错 - 装完必须重启 WebStorm，
Reload project或Invalidate caches都不生效
插件装上了但功能不出现，比如右键没新菜单、快捷键无效
大概率不是插件坏了，而是它依赖的上下文没就位：
-
ESLint插件需要项目根目录存在.eslintrc.js或package.json中有eslintConfig字段，否则连校验图标都不显示 -
GitToolBox要求当前项目已初始化 Git 仓库（即存在.git/目录），否则分支提示、提交统计全黑屏 - 两个插件同时注册了
Ctrl+Alt+L（格式化），其中一个会静默失效；去Settings → Keymap搜该快捷键，看绑定是否被覆盖 - 插件可能被禁用：在
Plugins → Installed页检查复选框是否勾选，禁用状态显示为灰色文字
最常被忽略的一点：插件启用 ≠ 功能就绪。很多插件只在满足特定项目结构或配置时才激活自身逻辑，空项目里装再多个插件也白搭。
