ThinkPHP多语言检测顺序为：先URL参数→再session→再cookie→再IP段匹配→最后HTTP_ACCEPT_LANGUAGE解析；语言包加载按模块级→应用级→框架级路径查找，找到即停。
ThinkPHP 多语言检测顺序是硬编码在 think\lang\Lang 类中的，不是靠配置文件优先级控制的，而是按固定逻辑逐层 fallback —— 你改配置项或加 config('lang.default_lang', 'zh-cn') 只影响默认值，不改变检测链条本身。
lang() 函数调用时的语言包加载顺序
每次调用 lang() 或 Lang::get() 时，框架会从当前请求上下文中提取语言标识，再按以下顺序查找并加载对应语言包：
- 先检查 URL 参数，如
?lang=ja-jp或/zh-cn/index/index（需路由支持）；该方式最高优先级，且会写入 session 和 cookie - 再查 session：
$_SESSION['think_lang']，存在则直接采用 - 再查 cookie：
$_COOKIE['think_lang']，默认 key 是think_lang，可由cookie_prefix和lang_cookie_name配置调整 - 再尝试 IP 段匹配：读取
lang.ip_map配置（如['192.168.1.*' => 'zh-cn', '203.123.*' => 'ja-jp']），命中则用对应语言 - 最后 fallback 到
$_SERVER['HTTP_ACCEPT_LANGUAGE']解析，例如zh-CN,zh;q=0.9,en-US;q=0.8会被截取第一个有效前缀zh-cn
注意：IP 段判断和 accept-language 解析都只在前几层全为空时才触发，不会并行或混合使用。
语言包文件路径的搜索优先级
确定语言标识（如 zh-cn）后，框架按如下路径顺序加载语言包文件，**找到即停**：
立即学习“PHP免费学习笔记（深入）”；
- 模块级：
app/模块名/lang/zh-cn.php（仅当前模块生效） - 应用级：
app/lang/zh-cn.php（全应用通用） - 框架级：
thinkphp/lang/zh-cn.php（极少自定义，一般不动）
模块级语言包可覆盖应用级同名键，但不会影响其他模块；若模块未定义某键，也不会自动 fallback 到应用级 —— 这是常见误解。必须显式继承或手动合并。
lang() 助手函数与模板中 {:lang()} 的行为差异
lang() 是运行时函数，每次调用都走完整检测链；而模板中 {:lang('key')} 实际调用的是 Lang::get()，它复用已初始化的语言环境，**不重新检测**。
- 如果在控制器里用
Lang::set('en-us')强制设定了语言，则后续所有lang()和模板{:lang()}都基于这个值，不再走上面的五层检测 - 缓存问题常出现在这里：语言切换后没清空
runtime/lang/下的编译缓存，导致旧语言文本仍被读取 - 语言包里若有 BOM 头（尤其 Windows 编辑器保存时），会导致 PHP 解析失败、返回空数组，
lang('xxx')直接返回'xxx'字面量 —— 这是最难排查的“翻译不生效”原因
动态切换语言时最容易忽略的三个点
手动切换语言（比如点击国旗图标）看似简单，但实际要同步处理三处状态，缺一不可：
- 调用
Lang::set('en-us')设置当前运行时语言 - 写入 session：
Session::set('think_lang', 'en-us')，否则下个请求又回退 - 写入 cookie：
Cookie::set('think_lang', 'en-us', 3600)，否则刷新页面丢失
漏掉任意一项，都会造成“点了切换但没反应”或“只生效一次”的现象。另外，Lang::set() 不会自动重载语言包，若语言包内容已在内存中加载过，需手动清空 Lang::$langList 或重启请求上下文。
