Lang::setLocale()调用无效的根本原因是语言包在中间件阶段已一次性加载，该方法仅修改语言标识却不触发重载；必须确保LoadLangPack中间件已启用、路径（app/lang/zh-cn.php）与命名规范、config/lang.php中allow_lang_list包含目标语言，且调用时机早于语言包加载（如中间件handle开头）。
Lang::setLocale() 调用后没生效？检查是否绕过了中间件加载时机
ThinkPHP6 的语言切换不是“设个变量就完事”，Lang::setLocale() 只改当前请求的语言标识，但语言包是否加载、翻译是否可用，取决于 LoadLangPack 中间件是否已执行且路径配置对齐。常见错误是：在控制器方法里先调 Lang::setLocale('en-us')，再调 lang('hello')，结果还是返回中文——因为中间件已在请求早期完成加载，此时改 locale 并不会触发重载。
- 确保
think\middleware\LoadLangPack已注册到app/middleware.php全局中间件数组中（不是只在路由里加） -
Lang::setLocale()必须在中间件执行前调用才可能影响加载，实际更稳妥的做法是：在中间件内或控制器__construct()里调用，并紧接着显式触发Lang::load() - 不要在模板或视图中调用
Lang::setLocale()，此时中间件早已执行完毕，语言包已锁定
语言包路径或文件名不合规，导致框架静默跳过
ThinkPHP6 对语言包路径和命名极其敏感，错一个字符就完全不加载，且不报错——lang('hello') 直接返回键名，看起来像“没切换”，实则是“根本没找到语言包”。
- 路径必须是
app/lang/zh-cn.php或app/lang/en-us.php，不能是app/lang/zh_CN.php、app/lang/zh-cn/common.php或lang/zh-cn.php - 文件内容必须以
return [ 'hello' => '你好' ];开头，前面不能有 BOM、空格、echo、var_dump等任何输出 - 确认
config/lang.php中'allow_lang_list'包含你传入的值，比如传en-us却只写了['en']，会被 fallback 到默认语言
GET 参数 lang=en-us 不起作用？优先级或开关没开
很多人以为加个 ?lang=en-us 就能切语言，结果毫无反应。这是因为侦测机制默认关闭，或参数名、顺序不匹配。
- 确认
config/lang.php中'detect_var' => 'lang'已设置，且'lang_switch_on' => true（TP6.0+ 需显式开启） - GET 参数优先级高于 Cookie 和 Header，但前提是中间件已启用且未被其他逻辑覆盖；如果同时设置了
Cookie: think_lang=zh-cn，而 URL 是?lang=en-us，那它应该生效——若不生效，说明中间件根本没跑 - 别用伪静态规则把
lang参数拦掉，Nginx 常见误配：if ($args ~* "lang=") { return 403; }，会导致参数根本进不到 PHP
多应用模式下语言包路径被忽略
如果你用了多应用（如 app/admin、app/api），默认的 app/lang/ 路径对子应用无效，每个应用需独立声明语言包位置。
立即学习“PHP免费学习笔记（深入）”；
- 子应用的语言包应放在
app/应用名/lang/zh-cn.php，例如app/admin/lang/en-us.php - 必须在对应应用的
config/lang.php（如app/admin/config/lang.php）中单独配置'lang_path'，不能只改根目录的配置 - 全局中间件
LoadLangPack在多应用下仍有效，但它会按当前应用上下文去拼路径，所以路径不对 = 包不加载
语言切换失效最常卡在“以为改了 locale 就完了”，其实框架加载语言包只有一次机会，在中间件阶段。路径、命名、配置、中间件启用状态，四者缺一不可，漏掉任意一个，lang() 就永远返回键名。
