allow_lang_list为空导致Lang::get()始终返回键名：当config/lang.php中allow_lang_list为空数组或未定义时，ThinkPHP6跳过语言校验，非法语言码被接受但加载失败，最终fallback到default_lang；若default_lang语言包也缺失，则Lang::get()直接返回原键名而非翻译内容。
allow_lang_list为空导致Lang::get()始终返回键名
当config/lang.php中allow_lang_list配置为空数组（[]或未定义），ThinkPHP6不会报错，但会跳过语言合法性校验——此时Lang::detect()拿到任意非法语言码（如zh_CN、ja、xx-yy）都直接接受，接着尝试加载lang/xx-yy.php这种不存在的路径，最终静默 fallback 到default_lang。更糟的是，如果default_lang对应的语言包也缺失，Lang::get('welcome')就原样返回字符串welcome，而不是翻译内容。
-
allow_lang_list必须显式声明为非空数组，哪怕只支持一种语言也要写['zh-cn'] - 不要依赖环境变量或条件判断动态生成该数组，框架在中间件初始化阶段就读取，延迟赋值无效
- 检查是否被
.env覆盖：若DEFAULT_LANG=zh-cn但没配ALLOW_LANG_LIST，TP6不会自动从default_lang推导出列表
Lang::getLangSet()返回空或意外值的排查点
Lang::getLangSet()返回空字符串或非预期语言码（比如en而非en-us），大概率不是代码调用问题，而是allow_lang_list与实际请求语言不匹配造成的“检测通过但加载失败”假象。框架检测到?lang=en，发现en不在allow_lang_list里，就放弃切换、维持默认；但如果你同时又写了cookie('think_lang', 'en')，而allow_lang_list里只有en-us，那Cookie值会被忽略，Lang::getLangSet()仍返回zh-cn。
- 用
var_dump(config('lang.allow_lang_list'))确认运行时实际值，别只看文件 - 检查
detect_var（默认lang）是否被路由规则拦截——比如伪静态规则把/index?lang=en-us重写成/index/lang/en-us，GET参数就丢了 - Header方式检测需配合
header_var（默认think-lang），且accept_language映射表必须包含对应条目，否则Accept-Language: ja不会转成ja-jp
多应用模式下allow_lang_list必须分应用配置
单应用项目在config/lang.php里配一次就够了；但多应用（如app/admin和app/api）时，每个应用的config/lang.php必须独立存在且含完整allow_lang_list。主应用的配置对子应用完全无效——这是最常被忽略的点。例如app/admin/config/lang.php里漏了en-us，即使主应用允许，admin模块里?lang=en-us也会被拒绝，Lang::getLangSet()始终是zh-cn。
- 子应用语言包路径为
app/admin/lang/zh-cn.php，不是app/lang/zh-cn.php - 子应用中间件栈（
app/admin/middleware.php）里也必须注册think\middleware\LoadLangPack - 避免在子应用里用
Lang::set()硬切语言后不调Lang::load()，因为子应用语言包路径和主应用不同，不手动加载就不会生效
插件或模块级语言隔离时allow_lang_list要单独维护
插件（如app/plugin/Pay）若需独立语言切换，不能复用主应用的allow_lang_list。插件语言包路径、Cookie键、检测逻辑全部隔离，主应用的allow_lang_list再全也不影响插件——插件自己没配，就永远只能加载默认语言。
立即学习“PHP免费学习笔记（深入）”；
- 插件内必须建
lang/zh-cn/common.php等目录，命名严格小写+短横线，lang/ZH-CN/或lang/zh_cn/均失效 - 插件中间件里调
Lang::set($lang)前，先用in_array($lang, ['zh-cn', 'en-us'])做白名单校验，别直接信任Cookie或GET值 - 前端切换插件语言时，必须操作插件专属Cookie（如
plugin_pay_lang），且path和domain要与后端一致，否则$request->cookie()读不到
allow_lang_list不是可选开关，而是语言路由的白名单防火墙。空或错配时，框架不会拦截请求，只会让后续所有Lang::get()调用失去上下文依据——这比报错更难定位。 
