PHP 8.4 中文乱码需从五方面修复：一、PHP文件须存为UTF-8无BOM；二、入口文件首加header('Content-Type: text/html; charset=utf-8')和mb_internal_encoding('UTF-8')；三、规避宝塔8.4.0编辑器编码丢失缺陷，改用本地编辑器处理；四、数据库连接强制设utf8mb4并统一库表字段排序规则；五、json_encode启用JSON_UNESCAPED_UNICODE并校验输入UTF-8合法性。
如果您在宝塔面板中运行 PHP 8.4 环境，页面输出中文显示为方块、问号或 Unicode 转义序列（如\u4f60\u597d），则极可能是输出编码链路中某环节未正确配置 UTF-8。以下是修复此故障的多种可行方案：
一、确认并修正 PHP 文件自身编码
PHP 源文件若以含 BOM 的 UTF-8、GBK 或其他非 UTF-8 无 BOM 编码保存，将导致解析阶段即引入不可见字节，干扰后续输出流。宝塔内置编辑器在 8.4.0 版本存在编码识别异常问题，更需人工校验。
1、在宝塔面板中进入网站根目录，右键点击对应 PHP 文件 → 选择“编辑”；
2、点击编辑器右下角当前显示的编码标识（如“UTF-8-BOM”或空白）；
立即学习“PHP免费学习笔记（深入）”；
3、在弹出菜单中选择“转为 UTF-8 无 BOM”，若无该选项，则复制全部内容；
4、关闭当前编辑窗口，新建一个空白文件，粘贴内容后手动选择“UTF-8 无 BOM”保存；
5、删除原文件，将新文件重命名为相同名称并上传覆盖。
二、强制设置响应头与内部编码
PHP 8.4 默认不自动发送 UTF-8 响应头，且对输出缓冲与内部编码一致性要求更高。缺失 header 声明会导致浏览器按历史缓存或默认编码（如 GBK）解析 HTML 内容。
1、打开主入口 PHP 文件（如 index.php），确保在任何 echo/print/HTML 输出之前插入以下两行；
2、第一行添加：header('Content-Type: text/html; charset=utf-8');；
3、第二行添加：mb_internal_encoding('UTF-8');；
4、若使用输出缓冲（ob_start），需在 ob_start() 后立即调用 mb_internal_encoding('UTF-8')；
5、保存后清空浏览器缓存并硬刷新（Ctrl+F5）验证效果。
三、修复宝塔 8.4.0 编辑器编码丢失故障
宝塔面板 v8.4.0 存在已知缺陷：PHP 文件首次双击编辑时编码显示正常，但保存一次后右下角编码标识变为空白，再次编辑保存即触发乱码。该问题与编辑器底层编码探测逻辑失效有关，非用户数据错误。
1、编辑 PHP 文件前，先在宝塔文件管理器中右键该文件 → 选择“下载”至本地；
2、使用 VS Code 或 Notepad++ 打开下载的文件，确认并转换为UTF-8 无 BOM格式后保存；
3、返回宝塔文件管理器，删除服务器上原文件；
4、点击“上传”，将本地修正后的文件上传至原路径；
5、此后所有修改均通过本地编辑器完成，禁止在宝塔 8.4.0 编辑器中进行二次保存操作。
四、统一数据库连接层字符集
即使页面编码正确，若从 MySQL 读取的数据在传输层被错误解码，仍会呈现乱码。PHP 8.4 对 utf8mb4 兼容性更严格，需显式声明连接字符集，避免回退至旧式 utf8（仅支持三字节）。
1、检查数据库连接代码，定位 mysqli 或 PDO 初始化位置；
2、若使用 mysqli：在 $mysqli = new mysqli(...) 之后，立即执行$mysqli->set_charset('utf8mb4');；
3、若使用 PDO：在 DSN 字符串中追加;charset=utf8mb4，例如 'mysql:host=localhost;dbname=test;charset=utf8mb4'；
4、同时确认数据库、表、字段均已使用 utf8mb4_unicode_ci 排序规则；
5、在 phpMyAdmin 或宝塔数据库管理中执行：ALTER DATABASE `your_db` CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci;
五、禁用 JSON 中文转义并捕获编码错误
PHP 8.4 的 json_encode() 默认对中文执行 \uXXXX 转义，虽非真正乱码，但影响可读性与调试；若输入含非法 UTF-8 字节（如截断 emoji、BOM、GBK 混入），json_encode 将直接返回 false 且静默失败。
1、将原有 json_encode($data) 替换为：json_encode($data, JSON_UNESCAPED_UNICODE | JSON_PARTIAL_OUTPUT_ON_ERROR)；
2、在调用后立即检查错误：if (json_last_error() !== JSON_ERROR_NONE) { error_log(json_last_error_msg()); }；
3、对可能含污染源的字符串（如 $_POST、文件读取结果），调用前执行：mb_convert_encoding($str, 'UTF-8', 'UTF-8') 强制重编码；
4、验证原始数据是否合法：var_dump(mb_check_encoding($str, 'UTF-8')); 返回 false 即需清洗。
