插件更新失败后仍显示灰色状态，是因为plugin.xml中since-build/until-build与WebStorm的完整Build Number（如WS-261.6890.123）不匹配，导致JVM拒绝加载；须严格按构建号下载对应.zip包，通过Install Plugin from Disk安装，并手动切换UI Language为Chinese (Simplified)后重启生效。
插件更新失败后仍显示灰色状态
插件列表里状态是灰色、Help → About 里看不到插件信息、UI Language 下拉为空——这不是网络问题，是 plugin.xml 中的 since-build 和 until-build 与当前 WebStorm 构建号不匹配，导致 JVM 层直接拒绝加载。
实操建议：
- 打开
Help → About，抄下完整 Build Number（例如WS-261.6890.123），不是2026.1这种简写 - 去 插件版本页，在
Compatible with列筛选出**完全一致**的构建号条目 - 点击右侧
Download，确保文件后缀是.zip（.jar或解压后安装均无效） - 关闭 WebStorm，进
Settings → Plugins → ⚙️ → Install Plugin from Disk…，选中该.zip文件
点 Update 后界面还是英文
Marketplace 页面右上角的 Update 按钮不校验构建号，只会覆盖一个“加载成功但注册失败”的空包。装完插件状态是 Enabled，但实际没注入资源 bundle。
实操建议：
- 别信 Marketplace 里的
Update available提示，它滞后且不可靠 - 装完必须手动进
Settings → Appearance & Behavior → System Settings → Customize → UI Language - 下拉框里必须出现
Chinese (Simplified)（注意括号、大小写，不是“简体中文”） - 选中后点
Apply，弹窗务必点Restart IDE；仅点Apply不生效
重启后报 “Plugin X is missing class Y”
这不是语言包本身出错，而是缓存错位导致类加载器找不到资源。上次崩溃或强制退出后，~/.WebStormXX.X/system/caches/（macOS/Linux）或 %LOCALAPPDATA%\JetBrains\WebStormXX.X\system\caches\（Windows）里的元数据已损坏。
实操建议：
- 执行
File → Invalidate Caches and Restart… - 务必勾选全部三项：
Clear file system cache and Local History、Clear VCS Log caches and indexes、Delete embedded browser engine cache and cookies - 不要点
Just Restart，它不清理任何缓存 - 重启后仍报错，再检查插件 ZIP 是否下载损坏（可比对官网页面提供的 SHA256）
手动改 plugin.xml 强制兼容？
网上流传的“用 vim 编辑 .jar 里的 plugin.xml，改 since-build”确实能绕过校验，但新版 WebStorm（2025.2 起）已强化签名验证，篡改后的包大概率被拒绝注册；即使侥幸加载，部分界面（如 Settings 搜索框、Quick Documentation 浮层）仍显示英文或乱码。
实操建议：
- 优先等官方更新，或降级 WebStorm 到插件已支持的稳定版（例如从
2026.1降为2026.1.1） - 若急需，可尝试用
npx jetbrains-plugin-manager工具辅助验证兼容性，但不推荐用于生产环境 - 所有手动修改都应在备份原 ZIP 后进行，且每次 IDE 升级后需重新评估
插件更新失败最常被忽略的点：Build Number 必须精确到末尾三位数字，比如 WS-261.6890.123 和 WS-261.6890.124 视为两个不兼容版本；差一位，就等于没装。
