ThinkPHP 6 中 lang_detect_var 配置项控制 GET 语言参数名，必须为 'lang_detect_var' => 'l'（非 detect_var），且需清缓存、确保值在 allow_lang_list 内、避免路由拦截或 Cookie/Header 优先级干扰。
lang_detect_var 配置改了但 ?l=zh-cn 不触发语言切换
不是配置写错了，而是你改的是错的配置项名。ThinkPHP 6 中控制 GET 参数名的配置项是 lang_detect_var，不是 detect_var——后者是旧版 TP5 的写法，TP6 已废弃，写了也完全不读。
检查 config/lang.php，确认存在且拼写准确：
'lang_detect_var' => 'l',
如果写成 'detect_var' => 'l' 或 'lang_var' => 'l'，框架会静默忽略，继续用默认的 lang。
- 改完后必须清空
runtime/cache/和runtime/config/目录，否则旧缓存配置仍在生效 - 确保
allow_lang_list包含你传的值，比如['zh-cn', 'en-us']，否则即使参数名对，值不在白名单里也会被丢弃 - 不要在中间件或控制器里手动调用
Lang::setLangSet()覆盖，它会绕过整个检测流程，导致后续Lang::getLangSet()返回值与实际加载的语言包不一致
GET 参数优先级被 Cookie/Header 覆盖了怎么办
系统固定顺序是 GET → Cookie → Header → HTTP_ACCEPT_LANGUAGE，这个顺序不能改，但你可以关掉后面几层，让 GET 真正“说了算”。
立即学习“PHP免费学习笔记（深入）”；
在 config/lang.php 中显式关闭不需要的渠道：
'use_cookie' => false,<br>'use_header' => false,
尤其注意 use_cookie 默认为 true，且 Cookie 名是 think_lang（由 cookie_var 控制），只要浏览器里存着这个 Cookie，它就永远比 URL 参数优先——哪怕你刚点了 ?lang=en-us，下一刷又回中文。
- 开发调试时建议临时设
'use_cookie' => false，避免反复清理浏览器 Cookie - 如果必须保留 Cookie 持久化，可在切换语言的接口里主动删掉旧 Cookie：
$this->cookie->delete('think_lang') - Header 检测依赖
think-lang请求头，若前端没发，这一层自然不生效；但 Nginx/Apache 若做了 Header 过滤（如屏蔽下划线），think-lang可能根本到不了 PHP 层
Lang::getLangSet() 总是返回默认语言，实际语言包却加载对了
这不是 bug，是 ThinkPHP 6 的设计逻辑：语言包加载和当前语言标识是两个独立流程。Lang::load() 可能根据 ?lang=en-us 成功载入 en-us.php，但 Lang::getLangSet() 仍返回 zh-cn，说明检测流程没把 GET 参数识别为最终语言。
最常见原因是路由拦截。如果你用了伪静态规则（比如 Nginx 把 /index/lang/en-us 重写成 index.php?s=/index/lang&lang=en-us），而路由定义里把 lang 当作路径变量而非查询参数，框架压根收不到 $_GET['lang']。
- 用
dump($this->request->param())和dump($_GET)对比，确认lang（或你配的lang_detect_var值）是否真实出现在$_GET中 - 检查路由配置里有没有
'lang' => '\w+'这类规则，它会把 lang 吞进路由参数，导致 GET 检测失效 - 别依赖
Lang::getLangSet()判断语言是否切换成功，直接用lang('hello')看输出内容更可靠
多语言切换后页面乱码，特别是中文提示文字
乱码和语言切换本身无关，是字符集没对齐。ThinkPHP 6 加载语言包时不做编码转换，所有 .php 语言文件必须保存为 UTF-8 无 BOM 格式。一旦文件里有 GBK 字节（比如用记事本另存为 ANSI），include 进来就是乱码，且无法修复。
- 用 VS Code 或 Sublime 打开语言文件，右下角确认编码显示为
UTF-8，不是GBK或UTF-8 with BOM - 别在语言包里写 HTML 实体（如
你好），直接写中文；TP6 不做 HTML 解码 - 如果语言包内容来自数据库或 API，确保那部分数据源也是 UTF-8，否则乱码会透传进来
真正容易被忽略的是：语言包文件本身编码错误，会导致整个应用的 lang() 输出不可逆损坏，而且没有任何报错提示。
