ThinkPHP语言自动识别需lang_switch_on开启、Accept-Language头解析及语言包加载三者配合，缺一不可；默认仅取首语言片段转为小写连字符格式（如zh-CN→zh-cn），不校验允许列表也不权重排序。
浏览器自动识别语言在 ThinkPHP 里不是“开个开关就自动生效”的功能，它依赖于 lang_switch_on 开启、Accept-Language 头解析逻辑、以及语言包加载时机三者严格配合。漏掉任一环，zh-cn 就永远是默认值。
lang_switch_on 开启后，Accept-Language 怎么被识别？
ThinkPHP 默认只取 $_SERVER['HTTP_ACCEPT_LANGUAGE'] 的第一个语言片段（如 zh-CN,zh;q=0.9,en;q=0.8 → 提取 zh-CN），然后转成小写并标准化为 zh-cn 格式。这个过程不校验是否在允许列表中，也不做权重排序，仅截取首项。
-
lang_switch_on必须设为true，否则整个检测逻辑跳过 - 检测顺序固定：先查
$_GET['lang']，再查Accept-Language，最后 fallback 到default_lang - 如果浏览器发来的是
ja或fr，而你没在Lang::setAllowLangList()里声明，它会被直接丢弃，不会尝试模糊匹配（比如ja→ja-jp） - Cookie 缓存只在首次检测成功后写入，后续请求优先读 Cookie，不再重新解析头
为什么设置了 lang_switch_on，但页面还是中文？
最常见原因是语言包路径或命名不匹配。ThinkPHP 按 lang/zh-cn.php 这种结构找文件，而不是 lang/zh.php 或 lang/zh_CN.php。大小写、分隔符、目录层级错一个，就加载失败，退回到默认语言。
- 语言包必须放在
app/lang/目录下（非app/common/lang/或app/extra/lang.php） - 文件名必须全小写 + 连字符，例如
en-us.php，不能是EN-US.php或en_us.php - 返回数组的键名要和代码中
lang('xxx')的参数完全一致，包括大小写和下划线 - 如果用模块级语言包（如
app/index/lang/zh-cn.php），需确认当前请求命中了该模块，否则不加载
如何让 Accept-Language 解析更准？
框架原生逻辑太简单，实际项目常需扩展。推荐在中间件里手动接管检测，绕过默认行为：
立即学习“PHP免费学习笔记（深入）”；
public function handle($request, \Closure $next)
{
$header = $request->server('HTTP_ACCEPT_LANGUAGE', '');
$langs = explode(',', $header);
$preferred = 'zh-cn';
foreach ($langs as $lang) {
if (preg_match('/^([a-z]{2})(?:-([a-z]{2}))?/i', $lang, $m)) {
$code = strtolower($m[1]) . (!empty($m[2]) ? '-' . strtolower($m[2]) : '');
if (in_array($code, ['zh-cn', 'en-us', 'ja-jp'])) {
$preferred = $code;
break;
}
}
}
\think\Lang::setLang($preferred);
return $next($request);
}
- 这段逻辑能处理
zh、zh-Hans、en-GB等变体，并映射到你实际支持的zh-cn或en-us -
\think\Lang::setLang()必须在任何lang()调用前执行，放中间件里比放控制器安全 - 不要在
__construct()里调用，构造函数执行时中间件尚未运行，语言设置无效
切换语言后模板不更新？检查缓存和加载时机
ThinkPHP 加载语言包是一次性的，lang() 函数内部缓存了翻译结果。如果你在请求中途调用 Lang::setLang()，已触发的 lang('xxx') 不会重算，只会返回旧语言的值。
- 语言设置必须在请求最早期完成，建议统一收口到中间件或
app_begin行为 - 模板里用
{:lang('xxx')}也没用——它和 PHP 层的lang()共享同一缓存 - 开启调试模式时可加日志确认是否真的加载了目标语言包：
\think\Lang::getLangSet()返回当前语言码 - 注意 BOM 头：语言包文件保存为 UTF-8 无 BOM，否则
require可能报错或静默失败
真正难的不是配置开关，而是确保从 HTTP 头解析、语言码归一化、包文件定位、到翻译函数调用，整条链路每个环节都对得上。尤其是 Accept-Language 值千奇百怪，别信浏览器开发者工具里看到的“简洁版”，抓包看原始 header 才靠谱。
