webstorm 2024.3+ 版本直接在 settings → appearance & behavior → system settings → customize → ui language 中选择 chinese (simplified) 并重启 ide 即可生效，无需安装任何汉化包或插件。
WebStorm 2024.3+ 直接改 UI Language 就行
新版 WebStorm（含当前 2026.1）已内置简体中文，不用装任何插件。关键不是“能不能汉化”，而是你有没有走对路径、做对动作。
常见错误现象：设置里找不到 Chinese (Simplified) 选项；点了 Apply 没反应；重启后还是英文。
- 先确认真实版本号：Help → About，看第一行——必须是
2024.3、2025.3或2026.1才支持内置中文；启动页 banner 上写的“2026.1”可能是 Toolbox 的营销文案，不可信 - 正确路径是 Settings → Appearance & Behavior → System Settings → Customize（不是旧版的 Language & Fonts）
-
UI Language下拉框选Chinese (Simplified)→ 点Apply→ 弹窗里必须点Restart IDE；仅点Apply不生效，热重载完全不触发语言切换
老版本（如 2023.3 及更早）必须装官方插件且手动启用
下拉菜单里没有中文选项？那基本就是老版本。但别急着搜“汉化补丁”——第三方包作者不是 JetBrains s.r.o. 的，一律跳过。
真正能用的只有插件名严格为 Chinese (Simplified) Language Pack，作者字段必须是 JetBrains s.r.o.。
- 进 Settings → Plugins，搜索该插件名，确认状态是
Enabled（右侧开关为蓝色），灰色 = 仅安装未启用 - 插件启用 ≠ 界面变中文：重启一次后，仍需再进 Settings → Appearance & Behavior → System Settings → Customize →
UI Language手动选中并再次重启 - 装完没效果？优先检查
bin/webstorm64.vmoptions（Windows）或webstorm.vmoptions（macOS/Linux）里是否残留-Duser.language=en这类硬编码参数
改完还是英文？大概率是系统级 locale 覆盖了设置
这类问题不报错，但界面死活不变——本质是 JVM 进程压根没收到中文指令。
Linux/WSL/macOS 终端用户尤其容易踩坑：如果用 open -a WebStorm 启动，IDE 会继承终端的 locale 设置。
- 终端执行
locale，确认LANG或LC_ALL不是C或POSIX；如果是，需在 shell 配置文件（如~/.zshrc）里加export LANG=zh_CN.UTF-8 - macOS 用户若通过终端启动，必须确保终端已设中文 locale，否则 UI Language 设置会被覆盖
- Windows 用户检查系统区域设置是否启用 UTF-8 支持（设置 → 时间和语言 → 区域 → 管理 → 更改系统区域设置 → 勾选 Beta: 使用 Unicode UTF-8 提供全球语言支持）
哪些地方“汉化失败”其实是正常设计
很多人以为 Quick Documentation（Ctrl + Q）还是英文就是设置失败，其实不是 bug，是分层设计决定的。
-
Quick Documentation里的 API 文档来自 TypeScript Server 或 JSDoc，语言包不覆盖 - 终端（
Terminal）输出、git提交信息、Node.js报错堆栈，由运行时环境决定，和 IDE 语言无关 - 第三方插件（如
GitToolBox、Rainbow Brackets）是否中文，取决于插件自身是否提供多语言支持 - 代码提示中的英文参数名、JSDoc 注释，属于语言服务层内容，不在 UI 翻译范围内
真正容易被忽略的是：UI Language 只控制菜单、对话框、设置项等 IDE 自身界面文字，它和你的代码、项目配置、插件行为完全解耦——改语言不会影响任何开发逻辑，但系统 locale 和 JVM 参数会悄悄绕过这个设置。
