PhpStorm乱码、mb_strlen异常、json_encode返回null,主因是文件真实编码与IDE解析编码不一致;须同步设置Project Encoding为UTF-8、确认文件真实编码(用file -i或bin2hex)、统一PHP运行时UTF-8环境,并注意BOM、.properties规范及Git/终端等隐性编码干扰。

PhpStorm 里文件乱码、mb_strlen 计算异常、json_encode 返回 null,八成不是字体或插件问题,而是「文件真实编码」和「IDE 解析编码」没对齐——必须同步改三处:项目默认编码、文件保存编码、PHP 运行时环境编码。
确认文件真实编码别信右下角显示
右下角写的 UTF-8 只是 PhpStorm “猜”的,不等于磁盘里存的真是 UTF-8。尤其老项目混了 GBK 文件,一打开就方块,本质是 IDE 用 UTF-8 去读 GBK 字节流。
- 终端执行
file -i your_script.php,看输出里的charset=是啥(如gbk、utf-8或iso-8859-1) - 在 PhpStorm 中右键文件 →
Reload project from Disk,弹窗会提示 “Detected encoding: GBK”,这才是真实线索 - 更硬核一点:
bin2hex(file_get_contents('a.php'))输出前几个字节,ef bb bf是 UTF-8 BOM,b4 fa是 GBK 的“你”字,比对就能断定
File Encodings 里必须设对这三项
进 File → Settings → Editor → File Encodings(macOS 是 PhpStorm → Preferences),以下三项不能只改一个:
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
-
Global Encoding:设为UTF-8(影响新建项目,默认即可,不建议动) -
Project Encoding:必须设为UTF-8(覆盖 Global,决定整个项目怎么读/写文件) -
Default encoding for properties files:保持ISO-8859-1(.properties 文件规范强制要求,改了反而读不出中文) - 勾选
Transparent native-to-ascii conversion(让.properties里的\u4f60\u597d正常转义显示,不是 bug)
已有乱码文件不能只点 Reload as
右下角点“Reload as GBK”只是临时用 GBK 解释当前二进制内容,关掉再打开还是乱——要永久修复得真正转码。
立即学习“PHP免费学习笔记(深入)”;
- 先右键乱码文件 →
Reload project from Disk,等弹窗提示 “Detected encoding: GBK” - 再右键 →
File Encoding → Convert to UTF-8(注意不是 “Reload with Encoding”) - 弹窗中务必勾选
Update source encoding to UTF-8,否则下次打开仍按旧编码读 - 批量操作:按住
Ctrl(macOSCmd)多选src/下 PHP 文件,右键统一Convert to UTF-8 - 避开
vendor/目录——第三方包编码不统一,硬转可能破坏签名或功能
转完还乱?检查这几个隐性坑
即使上面全设对了,乱码还可能藏在细节里:
- HTML 模板里写了
<meta charset="gbk">锛孭hpStorm 浼氫紭鍏堟寜杩欎釜澹版槑瑙f瀽鍐呭

















