WebStorm版本与Chinese Pack插件必须严格匹配，否则因plugin.xml中since-build/until-build不兼容导致插件拒绝加载，表现为灰色状态、Help→About无显示、UI语言选项为空；须依据Help→About中的完整Build Number（如WS-261.6890.123）在插件页面筛选完全匹配的.zip包，通过Settings→Plugins→Install Plugin from Disk安装。
WebStorm版本和Chinese Pack插件必须严格对齐
插件报错不是因为“装错了”，而是版本号没咬合上。JetBrains 对语言包做了强版本约束，plugin.xml 里写死的 since-build 和 until-build 不匹配，IDE 就直接拒绝加载——表现为插件列表里状态为灰色、Help → About 里看不到插件信息、甚至 User Interface Language 下拉框为空。
- 打开
Help → About，记下完整 Build Number（例如WS-261.6890.123），不是“2026.1”这种简写 - 去 插件页面，在
Compatible with列筛选出**完全匹配该 Build Number** 的版本（注意：有些小版本号如2026.1.1需要对应特定构建号） - 下载的是
.zip文件，不是.jar，更不能解压后安装 - 安装路径必须走
Settings → Plugins → ⚙️ → Install Plugin from Disk…，拖拽或 Marketplace 点 Install 都会失败
手动改 plugin.xml 强制兼容？风险极高
网上流传的“用 vim 编辑 jar 里的 plugin.xml，改 since-build”确实能绕过校验，但代价是插件可能加载失败、翻译缺失、甚至触发 JVM 层异常（比如 Operation not permitted 在 macOS 上直接卡 splash screen）。
- 新版 WebStorm（2025.2 起）已强化插件签名验证，篡改后的 jar 会被 IDE 拒绝注册
- 即使侥幸加载，部分界面（如 Settings 搜索框、Quick Documentation 浮层）仍显示英文或乱码，因为资源 bundle 路径和 API 入口已变更
- 不建议手动改包——优先等官方更新，或降级 WebStorm 到插件已支持的稳定版（如 2026.1 → 2026.1.1）
插件装上了但报 “Plugin X is missing class Y”
这不是语言包本身的问题，而是缓存错位导致类加载器找不到资源。WebStorm 启动时会从缓存中读取插件元数据，若上次崩溃或强制退出，缓存就可能损坏。
- 先执行
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，它不清理任何缓存 - 重启后若仍报错，再检查
~/.WebStormXX.X/system/caches/（macOS/Linux）或%LOCALAPPDATA%\JetBrains\WebStormXX.X\system\caches\（Windows）是否残留旧插件索引文件
汉化后其他插件开始报错？检查 workspace.xml 污染
Chinese Pack 插件激活过程中会重写项目级配置，尤其容易污染 .idea/workspace.xml 里的 <component name="ProjectView"> 节点，导致 Vue/TypeScript 插件无法正确解析文件结构，进而抛出 Cannot resolve symbol 或 Unresolved variable 类错误。
- 关闭 WebStorm，用文本编辑器打开
.idea/workspace.xml - 搜索
<component name="ProjectView">，删掉其中疑似被插入的<entry key="languagePack"或空<map>块 - 保存后重启，再进
File → Project Structure → Modules确认源根（Sources）路径未被意外清除 - 如果项目用了 Vite，还需检查
node_modules/.vite/deps是否被误删——汉化插件有时会触发错误的依赖扫描
真正麻烦的不是装不上，是装上之后 UI 语言切换了、字体调好了、缓存清干净了，结果某个第三方插件突然开始报一堆 class not found —— 这时候得翻 workspace.xml 和 idea.log，而不是再重装一遍汉化包。
