lang参数失效主因是rewrite丢参、loadlangpack中间件未启用或顺序错误、语言包路径/命名/格式不合规、以及语言侦测优先级覆盖；需逐层排查配置与执行时机。
lang 参数根本没进框架：先看 rewrite 是否丢参数
伪静态规则把 ?lang=en-us 整个 query string 丢掉了，是切换失效最常见原因。Nginx 的 try_files $uri $uri/ /index.php; 缺少 $query_string，Apache 的 RewriteRule 没加 [QSA]，都会导致参数丢失。
- 检查 Nginx 配置是否为
try_files $uri $uri/ /index.php?$query_string;（注意末尾$query_string） - 若部署在二级目录（如
/myapp/），fallback 路径必须同步改为/myapp/index.php?$query_string - 用 curl 测试：
curl -v "https://yoursite.com/index/index?lang=zh-cn"，看响应头中是否含 ThinkPHP 的 debug 信息——没有就说明请求压根没进框架 - 在
public/index.php开头加var_dump($_GET); die();，访问带?lang=en-us的 URL，输出为空即确认参数被 rewrite 截断
LoadLangPack 中间件未启用或执行太晚
think\middleware\LoadLangPack 是语言包加载的唯一入口，不启用它，lang() 就永远返回键名而不是翻译值；启用但顺序靠后，会导致验证器、系统异常等静态内容仍用默认语言。
- 打开
app/middleware.php，确认数组中已存在'think\middleware\LoadLangPack' - 该中间件必须放在所有自定义中间件之前（尤其不能在日志、权限类中间件之后），否则
$request->lang()取不到值 - 不要在控制器里调用
Lang::setLocale()或Lang::setLang()—— 此时语言包早已加载完毕，只影响后续新调用，对验证提示、throw_exception(L('xxx'))完全无效 - 多应用模式下，每个应用的
middleware.php都要单独加，不能只在根目录配
语言包路径、命名、内容格式三处硬性约束
ThinkPHP6 对语言包路径和文件结构极其敏感，任意一处不符就会静默跳过加载，且不报错。
- 路径必须为
app/lang/zh-cn.php（单应用）或app/api/lang/en-us.php（多应用），禁止zh_CN、zh、lang/zh-cn/目录形式 - 文件必须以
return [ 'welcome' => 'Welcome', ];开头，不能有 BOM、空格、echo、var_dump或任何输出 -
config/lang.php中的default_lang和allow_lang_list必须与文件名完全一致（大小写+短横线），例如'zh-cn'≠'zh_CN' - 如果用了域名切换（如
en.example.com），需在中间件中用Config::set('lang.default_lang', 'en-us')提前覆盖，不能依赖Lang::setLocale()
lang 参数被更高优先级机制覆盖或忽略
ThinkPHP 按固定顺序侦测语言：GET → Cookie → Header → HTTP_ACCEPT_LANGUAGE。一旦某环节命中，后续就不再尝试。容易误判“切换失效”，其实是被别的渠道覆盖了。
- 检查是否开启了
allow_url_lang => true：开启后，CheckLangBehavior会优先读$_GET['l']（或你设的VAR_LANGUAGE），此时?lang=en-us会被直接忽略 - 确认 Cookie 中是否存在
think_lang：如果用户之前存过，且use_cookie => true，那?lang=zh-cn就不会生效 - 前端请求头若带了
think-lang: zh-cn，而header_var => 'think-lang'已配置，则 Header 会覆盖 GET 参数——除非你把detect_var设为null关闭 GET 检测 - 用
Lang::getLangSet()打印当前实际生效语言，别只看 URL 参数是否存在
真正难排查的点往往不在语言包本身，而在请求生命周期早期：rewrite 规则、中间件顺序、配置覆盖时机。只要有一环没对齐，lang('xxx') 就永远只是字符串键名。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
