必须用 phpstorm 内置的 convert to utf-8 批量操作才能真正改写磁盘字节；reload with encoding 或 set encoding 仅改变 ide 解码方式，不修改文件内容，乱码依旧；右下角显示“utf-8”仅代表当前解码方式，并非文件真实编码，gbk 文件被误标为 utf-8 会显示方块，utf-8 文件被标为 gbk 则 mb_strlen() 计算错误、json_encode() 可能返回 null；验证真实编码应使用 file -i 或 vs code 右下角显示；批量转换前须统一设置 project encoding 和 default encoding，关键步骤是选中目录右键 → convert to utf-8 并勾选 update source encoding 和 convert encoding of file content。
必须用 PhpStorm 内置的 Convert to UTF-8 批量操作，才能真正改写磁盘字节；Reload with Encoding 或 Set encoding 都不碰文件内容，乱码照旧。
为什么右下角显示“UTF-8”不代表文件真是 UTF-8
PhpStorm 右下角状态栏写的编码只是它“当前按什么解码”，不是文件磁盘里存的字节。一个 GBK 编码的 a.php 被 IDE 误标为 UTF-8，中文就会显示成方块或问号；反过来，UTF-8 文件被标成 GBK，mb_strlen() 会算错、json_encode() 可能返回 null。
验证真实编码的可靠方式只有两个：
- 终端执行
file -i a.php（Linux/macOS），看输出中charset=后面是gbk还是utf-8; with bom - 用 VS Code 打开同一文件，右下角明确显示的编码（比 PhpStorm 更准）
批量转换前必须统一设置 Project Encoding 和 Default encoding
很多人只改了 Project Encoding，结果新写的 PHP 文件一保存还是 GBK——因为 Default encoding 还卡在系统默认值（比如 Windows 的 GBK）上。
正确路径：File → Settings → Editor → File Encodings（macOS 是 PhpStorm → Preferences）：
-
Global Encoding：设为UTF-8（一般不动） -
Project Encoding：必须设为UTF-8（决定整个项目读/写默认行为） -
Default encoding for properties files：保持ISO-8859-1（改了会导致.properties加载失败） - 务必勾选
Transparent native-to-ascii conversion（对含\uXXXX的配置文件必需）
真正有效的批量转换操作：Convert to UTF-8 + 勾选 Update source encoding
在 Project 视图中选中目标目录（如 src/ 或整个 project-root），右键 → File Encoding → Convert to UTF-8 —— 注意不是 Reload with Encoding，也不是 Set encoding。
弹窗中关键动作：
- 确认 Source encoding 选对（比如老项目大概率是
GBK） - 必须勾选
Update source encoding to UTF-8（这是最常翻车的一步；不勾选，下次打开仍按旧编码读） - 勾选
Convert encoding of file content（否则只改元数据，不转内容）
示例命令式理解：iconv -f GBK -t UTF-8//IGNORE old.php > new.php 是等效逻辑，但 PhpStorm 内置操作能自动处理 BOM、换行符、权限和部分损坏字节。
转换后仍乱码？重点排查 BOM 和混合编码
即使批量转完，仍有文件乱码，大概率是：
- 原文件带 BOM（
file -i显示charset=utf-8; with bom）：BOM 会触发 PHP 的headers already sent错误，也干扰 JSON 输出；必须重存为UTF-8 without BOM - 目录下混有不同编码文件（部分 GBK、部分 UTF-8、部分 GB2312）：PhpStorm 批量
Convert to UTF-8会按统一源编码处理，错选就雪上加霜；建议先用file -i扫描，分批处理 -
.idea/encodings.xml没提交到 Git：团队协作时，这个文件记录了各目录的编码偏好，不共享会导致别人打开仍是乱码
真正麻烦的从来不是“怎么点菜单”，而是搞清哪些文件实际是 GBK、哪些已经 UTF-8、哪些带 BOM——漏掉任意一种，批量操作就变成批量埋雷。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
