必须手动切换user interface language为chinese (simplified)并再次重启,插件安装成功不等于界面自动变中文;若下拉菜单无该选项,可能是插件未加载、网络未连通插件仓库或版本不匹配。

中文包装了但界面还是英文?检查 User Interface Language 设置
插件安装成功 ≠ 界面自动变中文。很多用户卡在重启一次后就以为完成了,结果菜单栏、设置项全是英文。这是因为 User Interface Language 默认仍为 English,必须手动切换。
操作路径:Settings → Appearance & Behavior → System Settings → Language → User Interface Language 下拉框里选 Chinese (Simplified)(注意不是“简体中文”文字,而是带括号的英文标识)→ 点 OK → 再次重启 WebStorm。
如果下拉菜单里压根没有这个选项,说明插件没真正加载成功,可能原因包括:
- 网络未连通 JetBrains 插件仓库(可临时关代理重试)
- 插件安装时 IDE 正在扫描项目,导致注册延迟(等右下角索引完成再查)
- 版本不匹配:旧版 WebStorm(如 2020.x)无法加载新版语言包,反之亦然
插件失效或安装失败?优先用 Invalidate Caches / Restart 清理
别急着删目录、重装、换包。90% 的中文包异常(比如突然回英文、提示“Plugin not loaded”)都源于缓存错位或索引损坏。WebStorm 官方唯一推荐的清理方式就是 Invalidate Caches / Restart。
操作时务必勾选三项:
-
Clear file system cache and Local History:否则窗口布局、断点、最近文件等残留会干扰语言资源加载 -
Clear VCS Log caches and indexes:尤其当你刚切过 Git 分支或重写过提交历史 -
Delete embedded browser engine cache and cookies:避免内置浏览器缓存污染 UI 资源加载路径
点 Invalidate and Restart,不是 Just Restart —— 后者完全不清理任何东西。
手动删缓存目录?只在 IDE 启动失败时才考虑
如果 WebStorm 根本打不开(比如 macOS 报 Error occurred during initialization of VM agent library fail),或者插件卸载后持续报 Plugin X is missing class Y,这时才需要手动清理。
目标很明确:只清缓存,不动配置。对应路径如下:
- macOS:
~/Library/Caches/JetBrains/WebStormXX.X - Windows:
%LOCALAPPDATA%\JetBrains\WebStormXX.X - Linux:
~/.cache/JetBrains/WebStormXX.X
删完后直接启动 WebStorm,它会自动重建缓存。不要碰 Application Support 或 Preferences 目录——那些是你的配置和插件数据,误删会导致所有自定义设置丢失。
重装 WebStorm 是最后手段,不是首选方案
重装解决不了缓存/配置错位问题,反而容易把老版本残留带进新安装中。真要重装,请先彻底清除四类路径:
- 配置目录:
~/Library/Application Support/JetBrains/WebStormXX.X(macOS)或%APPDATA%\JetBrains\WebStormXX.X(Windows) - 缓存目录(已列在上一条)
- 日志目录:
~/Library/Logs/JetBrains/WebStormXX.X或%LOCALAPPDATA%\JetBrains\WebStormXX.X\log - 偏好设置:
~/Library/Preferences/JetBrains/WebStormXX.X或%APPDATA%\JetBrains\WebStormXX.X\options
尤其注意:WebStorm 2024.2+ 已将中文包预置进 Marketplace,无需下载 .jar;第三方汉化包存在签名缺失、类型错位、快捷键失效等隐性风险,不建议使用。











