ThinkPHP 6 的 Lang 类完全不处理字符编码转换，仅加载预设编码（必须为 UTF-8 无 BOM）的语言包文件；乱码根源在于文件编码错误或响应头缺失，而非调用逻辑。
ThinkPHP 6 的 Lang 类不处理字符编码转换
直接说结论：ThinkPHP 自带的多语言系统（Lang 类、lang() 辅助函数）**完全不涉及字符编码转换逻辑**。它只负责按语言标识（如 zh-cn）加载对应 PHP 数组或 JSON 文件里的键值对，所有字符串内容必须在文件保存时就已是目标编码（通常是 UTF-8）。如果你看到乱码，问题一定出在语言包文件本身或 Web 服务器响应头，而非 ThinkPHP 调用过程。
语言包文件必须存为 UTF-8 无 BOM 格式
这是最常踩的坑。即使你用 lang('user.name') 正确调用，只要 app/lang/zh-cn.php 是 GBK 编码保存的，PHP 加载后字符串字节流就是错的，后续任何输出都不可逆地乱码。
- 用 VS Code、Notepad++ 等编辑器打开语言包，检查右下角编码显示，手动转为
UTF-8 without BOM - 不要依赖 IDE 自动识别 —— 某些旧版 Notepad++ 会把带中文的 UTF-8 文件误判为 GBK
- Linux 下可用
file -i app/lang/zh-cn.php验证实际编码；若返回charset=iso-8859-1或charset=us-ascii，基本可判定是 BOM 污染或编码错误 - Web 服务器需确保响应头包含
Content-Type: text/html; charset=utf-8，否则浏览器可能按默认编码（如 GBK）解析 UTF-8 字节流
需要编码转换时，别动 lang()，改数据源或加中间层
如果你不得不从非 UTF-8 数据源（比如遗留的 GBK 数据库字段、GBK 编码的 CSV 配置）读取多语言文本，lang() 本身无法帮你转码 —— 它只认 PHP 字符串。必须在传入前完成转换：
- 用
mb_convert_encoding($str, 'UTF-8', 'GBK')显式转码后再写入语言数组，例如：$text = db('lang')->where('key', 'welcome')->value('zh_cn'); $utf8_text = mb_convert_encoding($text, 'UTF-8', 'GBK'); return ['welcome' => $utf8_text]; - 避免在
lang()调用时实时转码（如mb_convert_encoding(lang('welcome'), 'UTF-8', 'GBK')），这会导致重复转码、性能损耗，且一旦源已为 UTF-8 就会崩坏 - 若用 JSON 语言包（
app/lang/zh-cn.json），JSON 解析器（json_decode）要求输入必须是 UTF-8，否则直接返回null—— 这时更要前置转码
ThinkPHP 5.1 与 6.x 在语言加载上的关键差异
老项目升级时容易忽略：TP5.1 的 Lang::load() 支持通过 $config['encoding'] 参数指定语言包编码（如 'encoding' => 'GBK'），但该参数在 TP6 中已被移除，不再提供任何编码适配能力。
立即学习“PHP免费学习笔记（深入）”；
- TP5.1 示例（已废弃）：
Lang::load('zh-cn.php', 'zh-cn', 'common', ['encoding' => 'GBK']); - TP6 只接受纯 UTF-8 文件，且不校验编码 —— 它假设你已准备好
- 如果强行在 TP6 中尝试传入非 UTF-8 文件，不会报错，但
lang()返回的字符串内容字节错误，后续htmlspecialchars()或 JSON 输出极易触发Warning: htmlspecialchars(): Invalid multibyte sequence
