Linux下ThinkPHP中文乱码需同时满足四条件：系统locale设为UTF-8、PHP文件为UTF-8无BOM、MySQL连接显式指定charset=utf8mb4、Web服务器配置charset=utf-8。
Linux系统locale未设置为UTF-8导致页面乱码
ThinkPHP在Linux上输出中文乱码，最常见原因是系统级编码未生效。即使PHP文件本身是UTF-8编码，phpinfo()显示default_charset为utf-8，若系统locale不是UTF-8，部分函数（如iconv()、mb_convert_encoding()）或CLI环境下的日志写入仍可能出错。
检查当前locale：
locale
若输出中LANG或LC_ALL不含UTF-8（例如显示en_US或空值），需补全：
- 临时生效：
export LC_ALL=en_US.UTF-8 - 永久生效：编辑
/etc/locale.conf，写入LANG="en_US.UTF-8"；或在/etc/environment中添加LC_ALL=en_US.UTF-8 - 确保该locale已生成：
locale-gen en_US.UTF-8（Ubuntu/Debian）或localectl set-locale LANG=en_US.UTF-8（CentOS 8+）
PHP文件保存为UTF-8无BOM格式被忽略
IDE（如PhpStorm、VS Code）默认可能保存为UTF-8 with BOM，而Linux下PHP解析器对BOM极其敏感——哪怕一个config.php带BOM，都可能导致header()前意外输出，进而引发模板渲染乱码或JSON返回失败。
立即学习“PHP免费学习笔记（深入）”；
验证与修复方法：
- 用
file -i app/config/database.php查看编码，输出含charset=bom即存在BOM - 批量清除BOM：
find ./app -type f -name "*.php" -exec sed -i '1s/^\xEF\xBB\xBF//' {} \; - VS Code中右下角点击编码名 → 选择
Save with Encoding→UTF-8（非UTF-8 with BOM） - ThinkPHP 6+建议统一使用
php -l检查语法前先过一遍BOM清理，避免部署后才暴露
MySQL连接未显式声明UTF-8导致数据层乱码
即使数据库、表、字段都是utf8mb4，ThinkPHP默认连接不加charset参数时，MySQL客户端可能回退到latin1，造成SELECT出来的中文变问号或方块。
ThinkPHP配置必须显式指定：
'mysql' => [
'hostname' => '127.0.0.1',
'database' => 'thinkphp',
'username' => 'root',
'password' => '',
'charset' => 'utf8mb4', // 必须写，不能省略
'prefix' => 'tp_',
]
同时确认MySQL服务端配置：
-
my.cnf中[client]段有default-character-set = utf8mb4 -
[mysqld]段有character-set-server = utf8mb4和collation-server = utf8mb4_unicode_ci - 重启MySQL：
systemctl restart mysql（或mariadb）
Web服务器未传递UTF-8响应头影响浏览器解析
Apache或Nginx若未设置Content-Type的charset，浏览器可能按ISO-8859-1解析HTML，导致静态文本乱码。这不是PHP问题，但常被误判。
对应处理：
- Apache：在
.htaccess或虚拟主机配置中加AddDefaultCharset UTF-8 - Nginx：在
server块内加charset utf-8;（注意是utf-8，非UTF-8） - ThinkPHP中也可强制：
header('Content-Type: text/html; charset=utf-8');，但应优先交由Web服务器处理，避免重复 - 用
curl -I http://yoursite.com检查响应头是否含charset=utf-8
真正麻烦的是多层叠加：系统locale错 + PHP文件带BOM + MySQL连接缺charset + Nginx没设charset——四个点只要漏一个，就可能看到乱码，且现象不一致（有的地方正常，有的地方异常）。排查时别只盯代码，先看locale、file -i、curl -I、SHOW VARIABLES LIKE 'char%'这四条命令的输出。
