WebStorm中文插件不生效主因是Build Number不匹配：Help → About中完整Build号（如WS-261.6890.123）必须与插件plugin.xml中since-build/ until-build精确一致，否则静默拒绝加载；需在JetBrains插件市场用Compatible with筛选精确匹配版本，下载.zip后通过Settings → Plugins → Install Plugin from Disk安装。
插件配置出错不是“重装就能好”的问题，多数情况是版本锁死、ID冲突或缓存污染导致的静默失效——比如插件列表里显示 Enabled，但 Help → About 里压根不出现名字，或 Settings → Language 下拉框空着。
Chinese Pack 插件不生效：Build Number 必须完全匹配
WebStorm 启动时会校验插件 plugin.xml 中的 since-build 和 until-build，只要不完全吻合当前 IDE 的 Build Number（如 WS-261.6890.123），就拒绝加载，且不报错、不提示。
- 打开
Help → About，抄下完整 Build Number（不是 “2026.1” 这种简写） - 去 JetBrains 插件市场页面，用
Compatible with筛选栏，**精确匹配该 Build Number** 的Chinese (Simplified) Language Pack版本 - 下载的是
.zip文件，不是.jar；安装必须走Settings → Plugins → ⚙️ → Install Plugin from Disk…，拖拽或 Marketplace 点 Install 都会失败 - 手动改
plugin.xml强行绕过？新版 WebStorm（2025.2 起）已启用签名验证，篡改后大概率卡在启动页或 UI 渲染异常
多个中文插件共存：keymap 和资源被覆盖
装了官方 Chinese (Simplified) Language Pack，又顺手点了 Translation 插件或第三方“汉化补丁”，结果菜单一半中文一半英文、Ctrl+Shift+N 失效——这不是缓存问题，是多个插件在抢 actions.xml 和 messages_zh.properties 的加载权。
- 进
Settings → Plugins，只保留 ID 为13710的官方插件，禁用所有含 “Chinese”“Translation”“Localize” 字样的插件 - 关掉 WebStorm，手动删掉
~/.WebStorm*/config/plugins/（macOS/Linux）或%APPDATA%\JetBrains\WebStorm*/plugins/（Windows）中名称含translation、zh_CN、patch的文件夹 - 重启后检查
Help → About末尾是否只有一行插件信息；若仍有Plugin 'xxx' is missing class Y报错，说明缓存损坏，需执行File → Invalidate Caches and Restart…并勾选全部三项
插件装上了但 Run Configuration 找不到命令
全局 npm 包（如 @vue/cli）在 Terminal 里能用，Run Configuration 却报 Command not found——因为 WebStorm 的运行配置默认不读取系统 PATH 或全局 node_modules/.bin，它只认当前项目 node_modules/.bin 或你显式指定的解释器路径。
- 进
Run → Edit Configurations → + → npm - 在
Package.json字段填项目根目录下的package.json路径（不是留空） - 在
Command字段填run，Scripts下拉选你要的脚本（如dev），不要手输npm run dev - 若用
pnpm，务必勾选Settings → Languages & Frameworks → Node.js and NPM → Enable pnpm support
插件更新按钮不出现：别信 Marketplace 页面显示的“最新版”
Marketplace 页面写着 “v2026.2.1”，但本地插件页仍显示 “v2026.1.0” 且无 Update 按钮——这是因为 WebStorm 只在已安装列表中检测到更高兼容版本时才显示按钮，且默认不拉取 EAP 版本。
- 先确认插件没被禁用：
Settings → Plugins → Installed中勾掉Show enabled only，看是否被隐藏 - 点右上角齿轮图标 →
Check for updates automatically关再开一次，强制刷新 Marketplace 缓存 - 部分插件（如
com.intellij.grazie.pro）分免费版和 Pro 版，未登录 JetBrains 账户或未绑定订阅，就看不到 Pro 版更新 - 从磁盘安装 ZIP 后没反应？必须重启 IDE 才真正加载；若之前通过 Marketplace 安装过同名插件，会触发
Duplicate plugin ID冲突，需先卸载旧版
最常被忽略的是：插件启用后不重启 WebStorm，.vue 文件仍被识别为纯 HTML，<script setup> 语法直接报错；还有人删了 .idea/workspace.xml 却忘了它可能已被写入错误的 keymap 绑定，导致右键菜单文字错乱——这些都不是“再点几下就能好”的事，得动手清、手动配、按 Build Number 对。
