ThinkPHP6语言检测严格区分大小写：因Lang::detect()直接用in_array($lang, $allow_lang_list)匹配且不标准化，ZH-CN与zh-cn被视为不同语言，导致匹配失败、fallback或静默加载失败。
ThinkPHP 6 默认不识别语言标识符大小写差异，zh-cn 和 ZH-CN 被视为不同语言，导致多语言切换失效或 fallback 失败。
为什么 think\facade\Lang::detect() 对大小写敏感
TP6 的语言检测逻辑依赖 $_SERVER['HTTP_ACCEPT_LANGUAGE'] 原始值（如 zh-CN,zh;q=0.9,en-US;q=0.8），并在 think\lang\Lang.php 中逐段解析、匹配配置项。它不做标准化处理，直接用 in_array($lang, $allowLang) 判断，而 PHP 的 in_array 默认区分大小写。
常见错误现象：
– 访问时浏览器发来 ZH-CN，但配置只写了 zh-cn → 匹配失败，回退到默认语言（如 en-us）
– 多语言包目录名为 zh-cn，但 URL 参数传 ?lang=ZH-CN → Lang::set('ZH-CN') 找不到对应目录，静默失败
- 语言配置在
config/lang.php的allow_lang_list数组中定义，必须与实际传入的标识符**字面完全一致** -
Lang::detect()不会自动转小写，也不会做str_replace('-', '_', ...)归一化 - 即使你手动调用
Lang::set(strtolower($lang))，也需确保该值存在于allow_lang_list中，否则仍被拒绝
如何安全地统一语言标识符大小写
不要在控制器里反复写 strtolower()，应在语言加载入口统一拦截并标准化。推荐在 app/middleware/LangMiddleware.php 中处理：
public function handle($request, \Closure $next)
{
$lang = $request->param('lang', $request->header('accept-language', ''));
if ($lang) {
// 提取第一个有效语言标签（如 ZH-CN,zh;q=0.9 → ZH-CN）
$lang = explode(',', $lang)[0];
$lang = trim($lang);
// 统一转小写 + 短横线标准化（兼容 zh_CN / zh_cn）
$lang = strtolower(str_replace('_', '-', $lang));
}
\think\facade\Lang::set($lang);
return $next($request);
}
- 必须放在所有依赖语言的中间件之前（如 i18n 相关逻辑）
- 避免使用
$_GET['lang']或input('lang')，优先走$request->param()，它已过 filter - 若项目同时支持下划线（如
zh_cn），此处理能自动转为zh-cn，与 TP6 内置约定对齐
lang 路由变量和 URL 参数的大小写陷阱
当使用路由定义如 Route::get('[:lang]/home', 'Index/home') 时，[:lang] 是原始字符串，不会被框架自动标准化。如果用户访问 /ZH-CN/home，则 $this->request->param('lang') 拿到的就是 ZH-CN。
立即学习“PHP免费学习笔记（深入）”；
- 别在控制器里直接用
Lang::set($this->request->param('lang'))—— 必须先清洗 - 若启用多语言路由前缀（如
zh-cn.home），确保route/alias.php中的 alias 键名也用小写，例如：'zh-cn' => 'home'，而非'ZH-CN' => 'home' - 模板中生成多语言链接时，用
url('index/home', ['lang' => 'zh-cn'])，不要拼接原始参数
验证语言包目录与配置是否真正对齐
TP6 加载语言包时，路径拼接为：lang_path() . '/' . $lang . '/' . $file。哪怕只差一个字母大小写，is_dir() 就返回 false，且不报错。
- 检查
app/lang/下的子目录名：必须全小写 + 短横线，如zh-cn、en-us、ja-jp；禁止ZH-CN或zh_CN - 确认
config/lang.php中allow_lang_list的值与目录名**逐字相同**：['zh-cn', 'en-us', 'ja-jp'] - Linux 部署前，用
find app/lang -type d | grep -E '[A-Z]'扫描非法大写目录
最易忽略的一点：语言包文件本身（如 app/lang/zh-cn/common.php）里的键名不区分大小写，但**目录结构和配置项的大小写必须零误差**——这和 Windows 开发时的“看起来能跑”完全不同。
