ThinkPHP多语言切换按URL参数→Cookie→Accept-Language请求头顺序检测，可配置微调；lang()返回空因语言包路径错误、BOM头、大小写敏感或未加载；控制器中用Lang::set()和Lang::load()主动切换，模板中{:lang()}需确保语言包提前加载且无语法错误。
ThinkPHP 的多语言切换不是靠 reload 页面或改配置生效的，而是在请求生命周期内动态识别并加载对应语言包——关键在于触发时机、参数来源优先级和语言包路径是否被正确解析。
lang_switch_on 开启后，语言切换按什么顺序决定？
系统不会只看 URL 参数就立刻切换。它有一套固定的检测链：先查 $_GET 中的变量（默认是 lang），没命中再查 Cookie（默认 key 是 think_lang），最后 fallback 到 Accept-Language 请求头。这个顺序不能改，但你可以通过配置微调：
-
'detect_var' => 'l'可把 URL 参数从?lang=en改成?l=en -
'cookie_var' => 'my_lang'能覆盖默认 Cookie 名，避免和其他系统冲突 -
'use_cookie' => false可禁用 Cookie 存储，强制每次靠 URL 或 header 决定 - 如果
'LANG_AUTO_DETECT' => false，那只有 URL 参数有效，header 和 cookie 全部忽略
lang() 函数为什么返回空或默认语言？
最常见原因是语言包没加载成功，而不是函数调用错了。ThinkPHP 不会报错，而是静默 fallback 到 default_lang。排查点包括：
- 语言包路径必须是
lang/zh-cn/common.php这种结构，lang/zh_CN/common.php或Lang/zh-cn.php都不认 -
common.php必须返回数组，且不能有 BOM 头（UTF-8 with BOM 会导致 parse error，但错误常被静默吞掉） - 键名大小写敏感：
lang('HELLO')和lang('hello')是两个不同 key - 如果你用了分组语言包（比如
admin.php），得手动加载：Lang::load(app()->getBasePath() . 'lang/zh-cn/admin.php')
如何在控制器里主动切换当前请求的语言？
不能直接改 Lang 类的内部状态，得走框架认可的流程。推荐做法是伪造一次“检测结果”：
立即学习“PHP免费学习笔记（深入）”；
在控制器中写：
$lang = 'en-us'; // 强制设置当前语言（绕过自动检测） \think\Lang::set($lang); // 手动加载该语言包（尤其当你用了非 common.php 的文件名时） \think\Lang::load(app()->getBasePath() . 'lang/' . $lang . '/common.php');
注意：这仅对当前请求有效；若想持久化（比如用户点按钮切换后下次还记住），必须配合写 Cookie：
-
cookie('think_lang', $lang, 3600)—— 默认有效期 1 小时 - 别忘了确保
'use_cookie' => true在配置中已开启 - Cookie 值必须在
'lang_list'配置范围内，否则下次请求仍会被重置为 default_lang
模板里 {:lang('xxx')} 不生效？检查这三处硬性限制
模板标签看似简单，但受加载时机和作用域限制：
- 语言包必须在模板渲染前加载完成，
CheckLangBehavior行为默认在app_begin触发，所以控制器里用Lang::set()后，模板才能拿到新语言 - 如果语言包放在模块目录下（如
app/admin/lang/zh-cn.php），要确认模块的 lang 目录已被纳入扫描路径（默认只扫应用根目录下的lang/） -
{:lang('xxx')}和{__('xxx')}效果一致，但后者是助手函数，更轻量；不过两者都依赖Lang实例已初始化，不能在__construct()里提前调用
最容易被忽略的是：语言包文件里不能有语法错误，哪怕一个多余的空格或注释符号，都会导致整个文件 require 失败，而 ThinkPHP 默认不抛异常，只沉默跳过。
