PhpStorm 启动报找不到中文语言包，因需匹配版本的官方 zh-CN 插件；安装后须配置 -Didea.language=zh-CN 并彻底重启；编辑器中文字体需手动设为系统中文字体，升级后需重装插件并恢复 VM 参数。
PhpStorm 启动时就报错说找不到中文语言包？
PhpStorm 默认不带中文界面支持，不是装了汉化包就能直接用。它依赖 JetBrains 官方提供的 zh-CN 语言插件，且必须匹配当前 PhpStorm 版本号。常见错误是下载了旧版插件（比如为 2022.1 编译的插件），在 2023.3 上启动直接失败，日志里出现 Plugin 'Chinese (Simplified) Language Pack' is incompatible 这类提示。
- 别去第三方网站下“一键汉化包”——大多已失效或含风险
- 优先走官方渠道：打开
Settings → Plugins → Marketplace，搜Chinese (Simplified) Language Pack - 确认插件详情页显示 “Compatible with your version”；如果灰色不可装，说明 JetBrains 还没为当前版本发布适配包
- 若暂无兼容版本，可临时降级到上一个稳定版（如从 2024.1 退回 2023.3），等官方更新
装完插件后重启还是英文界面？检查这三项
插件安装成功 ≠ 界面自动变中文。JetBrains 系列 IDE 的语言由 JVM 启动参数控制，插件只是提供翻译资源，真正生效靠的是 idea.language 配置项和启动时的 locale 设置。
- 进
Help → Edit Custom VM Options…，添加一行：-Didea.language=zh-CN（注意等号前后无空格） - 保存后必须彻底退出 PhpStorm（Mac 上要关掉 Dock 图标，Windows 要结束所有
jetbrains-phpstorm进程）再重开 - 如果仍无效，检查系统区域设置是否被强制覆盖：Windows 用户留意是否勾选了「Beta: Use Unicode UTF-8 for worldwide language support」——这个选项会导致 JVM 读取 locale 异常，建议取消勾选并重启系统
菜单/对话框是中文，但代码编辑区字体发虚或乱码？
中文界面启用后，编辑器默认字体可能不支持中文渲染，尤其 macOS 和 Linux 下常见 Monaco、DejaVu Sans Mono 这类纯西文字体，导致汉字显示为方块或模糊锯齿。
- 进
Settings → Editor → Font，把Font family改成系统自带的中文字体，例如：SF Pro Display（macOS）、Microsoft YaHei（Windows）、Noto Sans CJK SC（Linux） - 不要只改
Primary font，务必勾选Enable font ligatures下方的Show only monospaced fonts取消勾选，否则中文字体不会出现在下拉列表里 - 如果用了自定义主题（如 Dracula 或 One Dark），某些主题 CSS 会硬编码字体名，此时需手动编辑主题的
.jar文件或换回默认主题验证是否主题冲突
升级 PhpStorm 后中文界面突然消失
每次大版本升级（如 2023.3 → 2024.1）都会清空旧版插件缓存，并重置部分 VM 参数。你之前加的 -Didea.language=zh-CN 不会自动保留，插件也得手动重装。
立即学习“PHP免费学习笔记（深入）”；
- 升级完成首次启动后，立刻打开
Plugins页面，重新启用Chinese (Simplified) Language Pack - 再进
Edit Custom VM Options…确认-Didea.language=zh-CN还在，不在就补上 - 如果升级后连 Plugins 页面都打不开（白屏或卡死），可能是插件缓存损坏，删掉
~/.cache/JetBrains/PhpStorm2024.1/plugins目录（路径因系统和版本而异）再试
最麻烦的其实是 JetBrains 对中文本地化的节奏——有时候新功能上线了，对应翻译却拖一周才发布，这时候只能先忍着英文界面干活，或者切回上个版本。
