必须只保留官方chinese (simplified) language pack(id 13710),禁用所有其他翻译类插件,并手动清理plugins目录及.idea/workspace.xml中残留配置,否则多插件会争抢actions.xml和messages_zh.properties加载权,导致快捷键失效、菜单部分中文化。

多个中文插件同时启用导致快捷键失效
装了官方 Chinese (Simplified) Language Pack,又随手启用了 Translation 插件或第三方“汉化补丁”,结果 Ctrl+Shift+N 按下没反应、菜单部分中文化——这不是缓存问题,是多个插件在抢 actions.xml 和 messages_zh.properties 的加载权。
JetBrains IDE 不支持多语言包并行激活,后加载的插件会覆盖前者的快捷键绑定、菜单翻译和资源路径注册。
- 进
Settings → Plugins,只保留Chinese (Simplified) Language Pack(ID 必须是13710) - 禁用所有含 “Chinese”“Translation”“Localize” 字样的插件,尤其非 JetBrains 签名的
.jar补丁 - 关闭 WebStorm(macOS 要确认 Activity Monitor 中无残留进程),手动删掉
~/.WebStorm*/config/plugins/(macOS/Linux)或%APPDATA%\JetBrains\WebStorm*/plugins/(Windows)里名称含translation、zh_CN、patch的文件夹 - 重启后检查
Help → About末尾是否只显示一行插件信息;若出现Plugin 'xxx' is missing class Y报错,说明有残留未卸载干净
卸载插件后 .idea/workspace.xml 仍被污染
插件卸载了,但项目打开后 Project 视图顶部搜索框消失、右键菜单文字错乱、Settings 页面渲染异常——大概率是该插件曾写入过 .idea/workspace.xml,且未随插件卸载一并清理。这类修改常藏在 <component name="ProjectView"></component> 或 <component name="KeymapManager"></component> 节点里,IDE 启动时强制读取并应用。
- 关掉 WebStorm,进入项目根目录执行
rm .idea/workspace.xml(仅删这一个文件,不要动整个.idea) - 如有多个项目复用同一套配置习惯,可先备份:
cp .idea/workspace.xml .idea/workspace.xml.bak - 重启 WebStorm,它会自动生成干净的
workspace.xml;如需恢复某些自定义视图状态,再从备份里手工合并<component name="ProjectView"></component>外的节点
WebStorm 升级后中文包静默失效
升级到 2026.1 或 2026.2 后,插件列表里 Chinese (Simplified) Language Pack 显示 Enabled,但 Settings → Language 下拉里压根没有 Chinese (Simplified) 选项——不是网络或权限问题,而是插件版本与当前 Build Number 不匹配,导致加载失败或注册中断。
- 打开
https://plugins.jetbrains.com/plugin/13710-chinese-simplified-language-pack/versions,按「Compatible with」筛选你当前精确的 Build 号(例如WS-261.6890.123) - 下载对应
.zip文件(不是.jar),进Settings → Plugins → ⚙️ → Install Plugin from Disk…手动安装 - 安装后立刻检查
Help → About末尾的 Build Number 是否与插件说明一致;不匹配就换更细粒度的构建号 - 路径
Settings → Appearance & Behavior → System Settings → Language → User Interface Language必须选中Chinese (Simplified)(带括号的英文标识),点 OK 后必须点 Restart,仅 Apply 不生效
中文界面下字体渲染为方块或问号
菜单栏显示“文”“设”,不是插件没装好,是 JVM 渲染层找不到中文字形。Windows 默认 Segoe UI、macOS 默认 San Francisco 都不包含完整 GB18030 字符集,Linux 更常见此问题。
- 路径
Settings → Appearance & Behavior → Appearance,勾选Use custom font - 字体选
Microsoft YaHei(Windows)、PingFang SC(macOS)或Noto Sans CJK SC(跨平台首选) - 字号设为
13或14;改完必须点 OK 并彻底重启,否则字体缓存不刷新 - 若仍异常,检查系统是否禁用了中文字体子集(如 macOS 的 Font Book 中误停用 PingFang)
插件冲突最麻烦的地方不在报错,而在“半生效”:快捷键断一半、菜单混中英、搜索框渲染不出来却没日志提示。这类问题往往要同时检查插件状态、workspace.xml、UI 语言设置、JVM 字体四层,缺一不可。











