ThinkPHP自动检测浏览器语言需显式开启lang_switch_on配置并注册app_begin行为钩子，否则Lang::detect()不执行；其解析Accept-Language取首标签转小写，仅在allow_lang_list中才生效；优先级为GET参数>Cookie>默认值>HTTP_ACCEPT_LANGUAGE。
ThinkPHP 能自动检测浏览器语言，但默认不启用，必须显式开启配置并确保行为钩子注册正确，否则 Lang::detect() 不会执行。
如何开启自动检测并让 detect() 生效
自动检测不是开个开关就完事的——它依赖 app_begin 行为触发，且只在 lang_switch_on 为 true 时才运行。常见错误是只改了配置却没加行为定义。
-
config/lang.php中必须设置'lang_switch_on' => true（TP6）或'LANG_SWITCH_ON' => true（TP5/3.2） - TP6：确保
middleware.php包含'think\middleware\LoadLangPack' - TP5：在
tags.php的app_begin数组里加入'Behavior\CheckLangBehavior'（类名注意大小写） - TP3.2：同样在
tags.php加'Behavior\CheckLangBehavior'，且确认该类文件存在路径ThinkPHP/Extend/Behavior/CheckLangBehavior.class.php
浏览器 Accept-Language 怎么被解析
Lang::detect() 内部用 preg_match('/^([a-z\d\-]+)/i', $_SERVER['HTTP_ACCEPT_LANGUAGE'], $matches) 提取第一个语言标签，比如 zh-CN,zh;q=0.9,en;q=0.8 → zh-cn（转小写后）。但这个结果必须在允许列表里才生效。
- 务必通过
Lang::setAllowLangList(['zh-cn', 'en-us'])或配置项allow_lang_list/LANG_LIST显式声明支持哪些语言 - 如果浏览器发来
ja-JP，而你没在允许列表中写ja-jp，系统会 fallback 到default_lang，不会报错也不会提示 - 权重（
q=0.9）不参与匹配逻辑，只取第一个非空语言片段
URL 参数和 Cookie 优先级怎么排
TP5/TP6 的 detect() 方法有固定顺序：GET 参数 > Cookie > 默认值 > HTTP_ACCEPT_LANGUAGE。但要注意 Cookie 名和有效期由框架控制，不能随意改。
立即学习“PHP免费学习笔记（深入）”；
- GET 参数键名由
detect_var（TP6）或VAR_LANGUAGE（TP5/3.2）决定，默认是lang，即访问?lang=en-us - Cookie 名在 TP6 是
cookie_var（默认think_lang），TP5 是think_language；手动设 Cookie 必须用对应 key，否则检测不到 - Cookie 过期时间硬编码为 3600 秒（1 小时），TP5 源码里写死，无法通过配置修改
- 如果 GET 和 Cookie 同时存在且冲突，GET 始终胜出——这点常被忽略，导致“切了语言又变回去”
语言包加载失败的典型表现和排查点
页面没报错但文字仍是英文或乱码，大概率是语言包根本没加载成功。最隐蔽的问题是路径和命名不一致。
- TP6：语言包必须放在
app_name/lang/{lang}.php，例如app_name/lang/zh-cn.php，文件名必须全小写、带短横线 - TP5：支持多级路径，如
application/lang/zh-cn.php（应用级）、application/index/lang/zh-cn.php（模块级），但模块级需额外调用Lang::load() - 返回数组的键名必须是字符串，不能是中文或特殊符号；值可以是中文，但整个文件必须是 UTF-8 无 BOM 编码
- 用
Lang::get('hello')测试时，如果返回空字符串，先 dumpLang::range()看当前生效的语言是否是你预期的值
最易被跳过的环节是：允许语言列表没配、行为钩子没注册、语言包路径名大小写不匹配。这三个点任意一个卡住，自动检测就形同虚设。
