ThinkPHP中文乱码需全链路统一UTF-8无BOM编码：PHP文件（含config/控制器/模板）须为UTF-8无BOM；数据库连接层强制设charset=utf8mb4；HTTP响应头header('Content-Type: text/html; charset=utf-8')与HTML中<meta charset="utf-8">同步；每层须手动验证生效，缺一不可。
ThinkPHP 中文乱码不是单一环节出错，而是多个字符集配置点不一致导致的连锁反应。只要任意一环用了 gb2312、GBK 或带 BOM 的 UTF-8，而其他地方坚持 utf8mb4，就大概率出现 。
确认所有 PHP 文件都是 UTF-8 无 BOM 编码
这是最容易被忽略、也最常踩的坑：编辑器保存时默认带 BOM，尤其 Windows 下的记事本、老版 Notepad++。BOM 会提前输出三个不可见字节，导致 header() 调用失败，后续所有编码声明失效。
- 用 VS Code 打开文件 → 右下角点击编码名（如 “UTF-8”）→ 选 “Save with Encoding” → 选 “UTF-8”（不是 “UTF-8 with BOM”）
- 用
file -i your_file.php命令检查（Linux/macOS），输出含charset=utf-8; with BOM就要重存 - ThinkPHP 的
config.php、控制器、模型、视图模板，全部都要过一遍
数据库连接层必须显式指定 charset=utf8mb4
ThinkPHP 5/6 默认只在 DSN 里写 charset=utf8，但 MySQL 的 utf8 实际是阉割版（最多 3 字节），不支持 emoji 和部分生僻中文；真正兼容的是 utf8mb4。光改表字符集没用，连接层不匹配照样乱码。
- 在
database.php配置中，确保有：'charset' => 'utf8mb4' - 如果用 PDO，DSN 必须包含：
mysql:host=127.0.0.1;dbname=xxx;charset=utf8mb4 - 执行
SHOW VARIABLES LIKE 'character_set%';确认 MySQL 服务端已设character_set_server = utf8mb4
HTML 输出头和 meta 标签必须同步为 utf-8
ThinkPHP 模板渲染后，最终 HTML 流向浏览器。此时若 HTTP 响应头没设 charset，或 <meta charset> 写错，浏览器就会按默认编码（如 Windows-1252）解析，中文全变问号或方块。
立即学习“PHP免费学习笔记（深入）”；
- 入口文件
public/index.php顶部加：header('Content-Type: text/html; charset=utf-8');（必须在任何输出前） - 模板中
<head>内必须有：<meta charset="utf-8">（不要写成content="text/html; charset=utf-8"） - 避免在控制器里用
echo直接输出 HTML 片段，否则容易漏掉 header
别信“自动识别”，手动验证每层字符集是否真生效
很多开发者改完配置就以为好了，结果乱码照旧——因为某一层根本没生效。比如数据库配置写了 charset=utf8mb4，但实际连接时被中间件覆盖；或者 header() 被前面空行触发了 “headers already sent” 警告却没看到。
- 用浏览器开发者工具 → Network → 点开 HTML 请求 → 查看 Response Headers 中的
Content-Type是否含charset=utf-8 - 查数据库连接实际使用的字符集：
SELECT @@character_set_client, @@character_set_connection, @@character_set_results; - 在控制器里临时加一行：
dump(DB::getPdo()->getAttribute(PDO::ATTR_CLIENT_VERSION));看是否真连上了 utf8mb4
真正麻烦的不是改哪一项，而是改完之后没人去验证它是否真的在起作用。每个环节都得亲手确认，而不是靠“应该没问题”来推进。
