PhpStorm中文乱码本质是三处编码未对齐：项目默认、文件实际保存、IDE当前读取编码；应先用file -i或VS Code确认真实编码，再统一设置File Encodings中Project、Global及properties文件编码为UTF-8，对乱码文件依情况选择Reload as（仅重解释）或Convert to（重写磁盘），并排查BOM、PHP CLI、Git、终端及header声明等隐性问题。
PhpStorm 文件编码设置恢复，本质不是“重置”，而是重新对齐三处关键配置：项目默认编码、文件实际保存编码、IDE 当前读取编码。错位时直接改设置不如先确认真实状态。
怎么判断当前文件真实编码（别信右下角）
PhpStorm 右下角显示的 UTF-8 很可能是误判，尤其打开老项目里的 GBK 文件时，会直接渲染成方块或问号。
- 在终端执行
file -i your_file.php（Linux/macOS），看输出中的charset=值 - 用 VS Code 打开同一文件，右下角明确显示 “GBK” 或 “UTF-8 with BOM” 才算可信
- 如果显示
charset=utf-8; with bom，说明文件开头有 BOM（ef bb bf），这会导致 PHP 的headers already sent错误
File Encodings 里哪三项必须统一设为 UTF-8
进入 File → Settings → Editor → File Encodings（macOS 是 PhpStorm → Preferences），只改这三项：
-
Project Encoding：设为UTF-8（覆盖全局，影响整个项目读写行为） -
Global Encoding：也设为UTF-8（不建议留空或设为系统默认，避免新建项目继承错误值） -
Default encoding for properties files：设为UTF-8（否则messages_zh_CN.properties类资源文件必乱码）
⚠️ 注意：Transparent native-to-ascii conversion 勾选后，.properties 文件会自动转 \u4f60\u597d 这类 Unicode 转义，这是正常行为，不是乱码。
立即学习“PHP免费学习笔记（深入）”；
已有乱码文件是 Reload 还是 Convert
右下角编码提示旁有两个按钮，作用完全不同：
-
Reload as …：仅重新解释当前二进制内容，不改磁盘文件。适用于你**确定文件是 GBK，但被 IDE 当作 UTF-8 打开了** → 选GBK看是否恢复 -
Convert to …：按原编码读出内容，再以目标编码重写保存（会修改磁盘文件）。适用于你想把 GBK 文件永久转成 UTF-8 → 先Reload as GBK显示正常，再点Convert to UTF-8
转换后务必检查：用 hexdump -C your.php | head 看前 3 字节是不是 ef bb bf（BOM），如果是，就得删掉，否则 PHP 运行时报错。
为什么改完还乱？这几个隐性坑常被忽略
即使三处编码全设对了，仍可能乱码，问题往往藏在这些地方：
- PHP CLI 运行时编码没对齐：在
Edit Configurations → PHP Script的VM options里加-Dfile.encoding=UTF-8 - Git 仓库里混着旧编码文件：用
git status --ignored检查有没有未跟踪的乱码文件，用iconv -f GBK -t UTF-8 old.php > new.php预处理再提交 - 终端（Terminal）编码不是 UTF-8：进
Settings → Tools → Terminal，确认 Shell 启动脚本里有export LANG=en_US.UTF-8 - PHP 文件本身没声明输出编码：
header('Content-Type: text/html; charset=utf-8');要写在echo或任何输出之前
BOM 和 Git 混合编码是最容易漏掉的两个点，修完编码设置后，一定要顺手查一遍。
