必须用 IDE 内置的 Convert to UTF-8 才能真正修改文件磁盘内容；Reload with Encoding 和 Set encoding 仅改变 IDE 解码方式，不改字节，乱码依旧。
必须用 IDE 内置的 Convert to UTF-8，而不是 Reload with Encoding 或 Set encoding —— 后两者不改文件磁盘内容，乱码照旧。
为什么「右下角显示 UTF-8」不等于文件真是 UTF-8
PhpStorm 右下角状态栏写的编码只是它“当前按什么解码”，不是文件真实保存的字节。GBK 文件被强行标成 UTF-8，中文就会变方块或问号；反过来，UTF-8 文件被标成 GBK，mb_strlen() 会算错、json_encode() 可能返回 null。
验证真实编码的方法：
- 终端执行
file -i your_file.php（Linux/macOS）或iconv -f GBK -t UTF-8 your_file.php | head -c 50看是否报错 - 在 PhpStorm 中右键文件 →
Reload project from Disk，弹窗会明确提示Detected encoding: GBK - 极端情况用
bin2hex(file_get_contents('a.php'))查看原始字节：GBK 中文常见b4 fa，UTF-8 常见c3 a9
Project Encoding 和 Default encoding 的区别必须分清
Project Encoding 控制整个项目读取/保存文件时的默认行为；Default encoding 只影响新建文件的初始编码。很多人只改了前者，结果新写的 .php 文件一保存就变 GBK —— 因为 Default encoding 还卡在系统默认值上。
立即学习“PHP免费学习笔记（深入）”；
正确设置路径：File → Settings → Editor → File Encodings（macOS 是 PhpStorm → Preferences）
-
Global Encoding：设为UTF-8（一般不动，除非你改过 IDE 配置本身） -
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/），右键 → File Encoding → Convert to UTF-8 —— 注意不是 Reload with Encoding，也不是 Set encoding。
弹窗里关键选项：
- 务必勾选
Convert encoding of file content（否则只改 IDE 标签，不改文件内容） - 务必勾选
Update source encoding to UTF-8（否则下次打开仍按旧编码读） - 源编码选准：如果大部分是 GBK，就选
GBK；混有GB2312或CP936，先用iconv -f GBK -t UTF-8批量试转几个样本确认 - 避开
vendor/、node_modules/等第三方目录，它们不该动
命令行补救：当 IDE 转换出错或需自动化时
IDE 批量转换失败（比如检测错源编码导致部分文件变乱码），就该切到命令行兜底：
Linux/macOS 下一键转整个目录（保留原结构）：
find ./src -type f \( -name "*.php" -o -name "*.html" -o -name "*.js" \) -exec iconv -f GBK -t UTF-8 -c {} -o {}.utf8 \; -exec mv {}.utf8 {} \;
说明：
-
-c表示跳过无法转换的字符（避免中断） - 别直接覆盖写入，先输出到临时文件再
mv，防误操作 - Windows 用户可用 Git Bash 或 WSL，原生 CMD 不推荐处理编码
- 转换后检查 BOM：UTF-8 文件开头不应有
EF BB BF，如有且项目不需要，用sed -i '1s/^\xEF\xBB\xBF//' file.php清除
真正麻烦的不是转换动作本身，而是那些没被 IDE 捕获的隐性依赖：数据库连接的 charset=utf8mb4、HTTP header 中的 Content-Type: text/html; charset=utf-8、CLI 下 PHP 的 default_charset 配置 —— 编码统一是个链路，缺一不可。
