WebStorm汉化设置成功需满足三前提:版本≥2024.3、UI Language选Chinese (Simplified)并强制重启、清除-Duser.language=en等JVM参数及系统locale干扰;Quick Documentation、Terminal、第三方插件等内容保持英文属正常设计。

WebStorm 汉化设置是否成功,不能只看菜单文字变了没——很多用户点了 Chinese (Simplified)、重启了、界面大部分变中文了,但关键功能(比如右下角状态栏、弹窗按钮、快捷键提示)仍是英文,就以为“设置失败”。其实它可能已经部分生效,只是被底层环境覆盖了。
检查 Help → About 第一行版本号是否 ≥2024.3
这是所有判断的前提。启动 WebStorm 后,先按 Help → About,只看第一行(如 WebStorm 2026.1.2 或 Build #WS-261.6890.123):
- 若版本号是
2024.3、2025.3、2026.1等 ≥2024.3 的,说明走的是内置语言包路径,Settings → Appearance & Behavior → System Settings → Customize → UI Language下拉框里必须有Chinese (Simplified)选项 - 若版本号是
2023.3或更早,该下拉框大概率为空或无响应——此时你看到的“中文”很可能是插件强行注入的残缺翻译,或根本没生效 - 别信启动页 banner 上写的“2026.1”,那是 Toolbox 缓存值,不反映真实运行版本
确认 Settings 里 UI Language 已选中且 Apply 后点了 Restart IDE
新版(≥2024.3)设置后不重启 = 白设。常见误操作:
- 点
Apply后没点弹窗里的Restart IDE,只关掉设置窗口——语言资源根本没加载 - 用快捷键
Ctrl + Alt + S打开设置,却在旧路径Appearance & Behavior → System Settings → Language & Fonts里瞎找,那里没有UI Language选项 - 下拉框里选的是
Chinese(没括号没“Simplified”),或输错成chinese(大小写敏感),IDE 会静默 fallback 到英文
排查 JVM 和系统 locale 是否强制覆盖了语言
这类问题不报错,但会让所有设置失效——界面卡在英文,你甚至找不到哪里能改。必须手动检查:
- Windows:打开
bin/webstorm64.exe.vmoptions,删掉含-Duser.language=en或-Duser.country=US的整行 - macOS/Linux:检查
bin/webstorm.vmoptions,同样删掉-Duser.language=en类参数 - 终端执行
locale,确认LANG或LC_ALL不是C或POSIX(这些会让 JVM 强制走英文 fallback) - macOS 用户若用
open -a WebStorm启动,终端当前 locale 会透传给 IDE;建议改用 Dock 图标或 JetBrains Toolbox 启动
哪些地方永远是英文?不是设置失败,是设计如此
即使所有设置全对、版本匹配、重启到位,以下内容仍保持英文,属于正常行为,不是汉化没成功:
-
Quick Documentation(Ctrl + Q)里的 API 描述,来自 TypeScript Server 或 JSDoc,语言包不覆盖 - 终端(
Terminal)输出、git commit提示、Node.js堆栈信息,由运行时环境决定,和 IDE 的UI Language无关 - 第三方插件(如
GitToolBox、Rainbow Brackets)是否中文,取决于插件自身是否提供多语言支持 - 代码补全里的参数名、函数注释,属于语言服务层,不在 UI 翻译范围内
真正容易被忽略的是:只要 vmoptions 里有一行 -Duser.language=en,或者系统 locale 是 C,IDE 就永远不会收到中文指令——它不报错,只是安静地 fallback。











