ThinkPHP乱码主因是编码链不一致：文件、数据库、连接、输出各环节需统一UTF-8无BOM；default_charset仅影响响应头，不改变解析行为。
ThinkPHP 5/6 的 default_charset 配置没用？
不是配置失效，而是它只控制 HTTP 响应头里的 Content-Type 字符集（比如 text/html; charset=utf-8），不改变 PHP 文件本身的编码解析行为。Windows 下常见问题是：模板文件、语言包、数据库返回内容全是 GBK 编码，但 ThinkPHP 默认按 UTF-8 解析，一渲染就乱码。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 确认项目根目录下
runtime和public目录的 PHP 文件（尤其是index.php）本身保存为 UTF-8 无 BOM 格式 —— Windows 记事本默认存的是 ANSI（GBK），这是最常被忽略的源头 - 在
config/app.php中显式设置：'default_charset' => 'utf-8'（小写，注意不是UTF8或UTF-8大写） - 如果用了多语言，检查
lang/zh-cn.php等语言包文件是否也是 UTF-8 无 BOM；有 BOM 会导致header already sent错误并间接引发乱码
MySQL 连接层乱码：ThinkPHP 的 database.php 配置要点
Windows 下 MySQL 客户端默认字符集常为 gbk，而 ThinkPHP 建立连接时若未强制指定，PDO 就会沿用这个环境值，导致查出来的中文变成 ???? 或错乱字形。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在
config/database.php的'dsn'里追加;charset=utf8mb4（不是utf8），例如：'dsn' => 'mysql:host=127.0.0.1;dbname=thinkphp;charset=utf8mb4' - 同时确保数据库、表、字段的默认字符集都是
utf8mb4，执行SHOW CREATE TABLE user;看建表语句里有没有CHARSET=utf8mb4 - 不要依赖
'params' => [\PDO::MYSQL_ATTR_INIT_COMMAND => 'SET NAMES utf8mb4']，它在某些 PDO 版本下会被忽略，dsn中声明更可靠
模板输出前被自动转义：{:htmlspecialchars($str)} 导致二次编码
Windows 开发者常把字符串先用 htmlspecialchars() 处理再传给模板，结果 ThinkPHP 的 {$var} 又默认开启自动转义（template.default_filter 默认含 htmlspecialchars），同一段中文被转两次，显示成一堆 HTML 实体。
Windows 命令行编码与兼容规范。涵盖 GBK/UTF-8 编码、PowerShell/pwsh 互操作、Python/Node.js、Git 配置及代码生成规则。适用于 Windows 10/11 + MSYS2/Git Bash 环境下的所有命令行操作。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 检查
config/template.php中的'default_filter'，如果不需要全局转义，直接设为空数组：'default_filter' => [] - 若需保留部分转义，改用
{|raw}输出可信内容，例如：{$name|raw}，避免在 PHP 层提前调用htmlspecialchars() - 特别注意：Windows 下用
iconv('GBK', 'UTF-8', $str)转码时，若源字符串实际是 UTF-8，会直接损坏 —— 先用mb_detect_encoding($str, ['UTF-8', 'GBK'], true)判断，别硬转
IDE 和编辑器没配对：VS Code / PHPStorm 显示正常但运行乱码
编辑器显示是 UTF-8，但保存时用了 BOM 或换行符是 CRLF，PHP 解析器在 Windows 下对 BOM 敏感，开头的 \xEF\xBB\xBF 会被当普通输出，破坏 header 发送，进而让浏览器无法正确识别 charset。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- VS Code：右下角点击编码名 → 选择
Save with Encoding→UTF-8（不是UTF-8 with BOM） - PHPStorm：File → Settings → Editor → File Encodings → 全局编码、项目编码、默认编码全部设为
UTF-8，勾掉Transparent native-to-ascii conversion - 用命令行验证：
file -i app/index/controller/Index.php（Linux/macOS）或PowerShell: Get-Content xx.php -Encoding Byte | Select -First 3查前 3 字节，EF BB BF就是 BOM
真正卡住人的往往不是某个配置项，而是多个环节编码状态不一致：文件存的是 GBK，数据库连的是 gbk，但 PHP 脚本又声明自己是 UTF-8 —— 这种混合状态在 Windows 下特别隐蔽，得逐层确认原始字节流，而不是只看“看起来是不是中文”。
