ThinkPHP 的 lang 参数需开启 lang_switch_on 且未被中间件覆盖才生效，lang 值须在 lang_list 范围内、目录名大小写敏感；分页需显式传入 query 参数保留 lang；lang() 函数不解析 URL，仅依赖已激活语言环境。
ThinkPHP 多语言切换本身不依赖 query 字符串自动生效，lang 参数能否起作用，取决于你是否开启了 lang_switch_on 且没在中间件里提前覆盖了语言设置。
lang 参数为什么有时不生效
常见现象是加了 ?lang=en-us 页面却还是中文——根本原因不是 URL 没传过去，而是框架没走到自动识别逻辑里。
-
lang_switch_on必须设为true，否则整个多语言探测流程直接跳过 - 如果用了自定义中间件（比如手动调用
Lang::setLang()），它会早于Lang::detect()执行，导致 URL 参数被忽略 -
lang值必须在lang_list配置范围内，比如配置了['zh-cn', 'en-us']，但传?lang=en就不会匹配成功 - Linux 环境下目录名大小写敏感：
en-us≠EN-US，语言包放错位置也不会报错，只是静默失效
如何让 ?lang=en-us 正确触发切换
前提是已按规范建好 lang/en-us/common.php 并开启多语言。关键在配置和加载时机：
- 在
config/app.php中确认启用并声明支持列表：'lang_switch_on' => true、'default_lang' => 'zh-cn'、'lang_list' => ['zh-cn', 'en-us'] - 不要在控制器或模型里手动调用
Lang::setLang()，除非你完全接管语言判定逻辑 - 确保没有中间件提前执行了
Lang::setLang()—— 一旦执行，后续Lang::detect()就不会再改语言 -
Lang::detect()默认只检查GET['lang']、Cookie['think_language']、Session['think_language']和Accept-Language头，不读其他字段
分页链接里怎么保留 lang 参数
ThinkPHP 分页默认不携带 query 参数，lang 会丢失，导致翻页后变回默认语言。解决方法是在 paginate() 的第三个参数中显式注入：
立即学习“PHP免费学习笔记（深入）”；
->paginate(15, false, ['query' => request()->param()])
这行代码会让分页生成的链接自动带上当前所有 GET 参数，包括 lang=en-us。注意两点：
-
request()->param()返回的是合并后的全部参数（GET + POST），但分页只关心 GET，所以实际更稳妥的是用input('get.')或request()->get() - 如果你在中间件里动态设置了语言，
lang参数其实已不参与渲染，此时保留它只是“看起来一致”，实际不影响翻译结果
lang() 函数内部不解析 query，别指望它读 URL
lang('hello') 的行为和当前请求的 URL 完全无关，它只依赖当前已激活的语言环境（由 Lang::setLang() 或 Lang::detect() 设定）。你不能写 lang('hello', ['lang' => 'en-us']) 来临时切语言——这个函数不接受语言上下文参数。
真要按需切换，得手动加载：
Lang::load(APP_PATH . 'lang/en-us/common.php'); echo lang('hello');
但这种方式绕过了框架的语言包管理机制，容易和缓存、复数语法、占位符解析冲突，仅适合极简场景。绝大多数情况，应该让语言在请求入口就确定下来，而不是在模板或循环里反复切换。
最易被忽略的一点：语言包文件返回数组时，键名必须和 lang() 调用的字符串完全一致，包括大小写和空格；缺失 key 时默认返回原字符串，线上环境不会报错也不会提示，靠肉眼很难发现漏翻。
