webstorm 2024.3+ 版本直接在 settings → appearance & behavior → system settings → customize → ui language 中选择 chinese (simplified) 并重启 ide 即可汉化，无需安装插件；老版本需装官方 chinese (simplified) language pack 插件并手动切换语言后二次重启。
WebStorm 2024.3+ 直接改 UI Language，别装插件
新版根本不需要下载、安装、重启汉化包——装了反而容易冲突。打开 Help → About 看第一行版本号，只要是 2024.3 及之后（比如当前 2026.2），直接进 Settings → Appearance & Behavior → System Settings → Customize → UI Language，选 Chinese (Simplified)，点 OK 后必须点击「Restart IDE」。如果下拉菜单里没有这个选项，说明你看到的不是真实版本（启动页 banner 可能缓存），以 About 窗口为准。
老版本（2023.3 及更早）只认官方插件，且必须手动切语言
插件名必须是 Chinese (Simplified) Language Pack，作者必须是 JetBrains s.r.o.。其他任何名称（“汉化补丁”“CN语言包”）都不可信。安装路径是 Settings → Plugins → Marketplace 搜 Chinese，找到后点 Install。但注意：装完不等于变中文——你还得再进 UI Language 设置项，手动选 Chinese (Simplified)，Apply 后强制 Restart。如果下拉为空，先关代理重试，或等右下角索引完成后再查，插件注册常被索引阻塞。
重启后界面乱码/方块？换字体不是可选项
这不是翻译没生效，是 JVM 渲染层找不到中文字形。Windows 默认 Segoe UI、macOS 默认 San Francisco 都不包含完整 GB18030 字符集，导致菜单项显示为方块或问号。进 Settings → Appearance & Behavior → Appearance，勾选 Use custom font，字体选 Microsoft YaHei（Win）、PingFang SC（macOS）或跨平台首选 Noto Sans CJK SC，字号设为 13 或 14，改完点 OK 并彻底重启——字体缓存不刷新，改了也白改。
Ctrl+Shift+N 搜不到文件？大概率是 workspace.xml 被污染
汉化插件激活时可能偷偷改写 .idea/workspace.xml，尤其爱动 <component name="ProjectView"></component> 节点里的 searchDepth 或 showMembers，一旦设为 false，Project 栏顶部搜索框就完全失能——输不进字、回车无反应、甚至整个框都不渲染。解决方法：关掉 WebStorm（macOS 注意菜单栏残留进程），进项目根目录执行 rm .idea/workspace.xml（千万别删整个 .idea），重启后 IDE 会自动生成干净配置。若问题复现，说明插件主动写入，可临时禁用汉化插件再对比 diff。
