PHPStorm中文乱码主要因文件编码与IDE读取编码不一致，应先通过file -i或VS Code确认真实编码，再统一设置File Encodings中Global、Project及properties文件编码为UTF-8，对乱码文件依情况选择Reload as或Convert to，并排查BOM、终端编码、Git及引入文件等隐性问题。
PHPStorm 中文乱码，八成是文件编码没对齐，不是字体或语言包的问题。 先别急着换字体、装插件，直接看文件实际保存的编码和 IDE 读取时用的编码是否一致。绝大多数乱码场景，改对 File Encodings 就能解决。
确认当前文件真实编码（别信右下角显示）
PHPStorm 右下角显示的“UTF-8”可能只是它“猜”的，不一定准确。尤其当你打开一个老项目里的 GBK 文件时，IDE 往往误判为 UTF-8，一打开就全是方块或问号。
- 右键点击乱码文件 → Reload project from disk，再看右下角编码提示是否变化
- 更可靠的方式：在终端执行
file -i your_file.php（Linux/macOS）或用 VS Code 打开该文件，右下角明确显示“GBK”“GB2312”或“UTF-8 with BOM” - 如果显示
charset=utf-8; with bom，这就是典型隐患：BOM 会导致headers already sent或页面开头多出空白
统一设置 File Encodings（关键三处）
进入 File → Settings → Editor → File Encodings（macOS 是 PhpStorm → Preferences），这里三个地方必须协同修改：
-
Global Encoding：设为UTF-8（影响新建项目默认行为） -
Project Encoding：设为UTF-8（整个项目默认编码，覆盖 Global） -
Default encoding for properties files：也设为UTF-8（否则messages_zh_CN.properties这类资源文件会乱码） - ⚠️ 注意：
Transparent native-to-ascii conversion勾选后，.properties 文件会自动转 Unicode 转义（如\u4f60\u597d），这是正常行为，别因此误判为乱码
已有乱码文件怎么救（Reload vs Convert）
对已经打开但显示乱码的文件，右下角编码提示旁有两个操作按钮，别点错：
立即学习“PHP免费学习笔记（深入）”；
-
Reload as …：仅重新以指定编码解释当前二进制内容（不改文件本身）。适用于你**确定文件是 GBK 但被当 UTF-8 打开了** → 点它 → 选
GBK→ 看是否恢复正常 -
Convert to …：把文件内容按原编码读出，再以目标编码重写保存（**会改磁盘文件**）。适用于你想把 GBK 文件永久转成 UTF-8 → 先
Reload as GBK让它显示正常，再点Convert to UTF-8 - 转换后务必检查：PHP 文件开头有没有隐藏的 BOM（可用
hexdump -C your.php | head查看前 3 字节是否为ef bb bf）
为什么改了还乱？注意这几个隐性坑
即使上面全设对了，仍可能乱码，原因常藏在细节里：
- 项目里混用了不同编码的文件（比如部分 JS 是 UTF-8，部分 PHP 是 GBK），
Project Encoding只能设一个，无法兼顾 → 必须逐个Reload as …校正 - PHP CLI 运行脚本输出中文乱码，跟编辑器设置无关，而是终端或 JVM 编码问题 → 需在
phpstorm64.exe.vmoptions加-Dfile.encoding=UTF-8 - 使用
include或require引入的文件，如果自身带 BOM，会导致整个输出提前发送 HTTP 头 → 即使页面显示正常，header()也会失败 - Git 提交后别人拉下来又乱码？因为 Git 默认不处理编码，建议团队统一用 UTF-8 无 BOM，并在
.editorconfig中声明charset = utf-8
真正麻烦的从来不是“怎么设”，而是“设完要不要动文件”。Reload 是临时查看，Convert 是永久修正——选错一步，可能覆盖掉原始中文。动手前先备份，尤其是批量 Convert 时。
