ThinkPHP语言包加载需严格遵循路径、命名和配置规范：必须置于app/lang/{lang}.php等指定路径，语言标识符为小写短横线格式（如zh-cn），且需启用LoadLangPack中间件；动态加载须用绝对路径调用Lang::load()；allow_lang_list必须是数组且配置在lang.php中；文件禁止UTF-8 BOM。
ThinkPHP 对语言包路径有硬性约定，不是随便放个 lang/zh_CN.php 就能加载的——路径名、文件名、目录结构三者错一个，Lang::get() 就返回空字符串，且不报错，排查起来特别隐蔽。
语言包必须放在固定位置，且命名严格用短横线
ThinkPHP 只识别以下三类路径下的语言文件（按加载优先级从高到低）：
-
app/lang/{lang}.php（应用级，推荐放这里） -
app/{module}/lang/{lang}.php（模块级，如app/admin/lang/zh-cn.php） -
thinkphp/lang/{lang}.php（框架级，不建议改）
关键点：
- 语言标识符必须是小写 + 短横线格式，例如
zh-cn、en-us，zh_CN或zhcn都不会被识别 - 文件必须是
.php后缀，不能是.inc或其他 - 目录名不能带空格或中文，也不能是
language、i18n这类自定义名
lang() 函数失效？先检查是否漏了中间件
在 ThinkPHP 6+ 中，语言包自动加载依赖 think\middleware\LoadLangPack 中间件。如果没启用，即使路径和命名全对，lang('hello') 也永远返回原始键名。
立即学习“PHP免费学习笔记（深入）”；
确认方式：
- 检查
app/middleware.php是否包含'think\middleware\LoadLangPack' - 多应用模式下，每个子应用（如
app/admin/middleware.php）需单独配置 - 若使用了自定义中间件分组，确保该中间件在请求生命周期早期执行（不能放在最后）
临时验证：在控制器里加一行 dump(Lang::getLangSet());，输出为空说明中间件没生效或语言未检测成功。
如何动态加载非标准路径的语言包
有些场景需要加载插件语言包、用户上传的语言包，或兼容旧项目结构，这时不能靠自动加载，得手动 Lang::load()。
注意三点：
- 路径必须是绝对路径，推荐用
APP_PATH . 'common/lang/zh-cn.php'，别用相对路径 - 文件内容必须是
return [...];，不能有 echo、header 或多余输出 - 调用
Lang::load()必须在Lang::get()之前，且最好在控制器initialize()方法中完成
示例：
public function initialize()
{
Lang::load(APP_PATH . 'plugin/lang/' . Lang::getLangSet() . '.php');
}
允许语言列表配置错误导致自动切换失效
开启 lang_switch_on 后，系统会从 $_GET['lang'] 或 HTTP_ACCEPT_LANGUAGE 提取语言，但最终是否采纳，取决于是否在 allow_lang_list 里。
常见疏漏：
- 配置项写成
allow_lang或allowed_langs—— 正确名是allow_lang_list - 值是字符串而非数组，例如
'allow_lang_list' => 'zh-cn,en-us'—— 必须是数组：['zh-cn', 'en-us'] - 没在
config/lang.php中配置，而误写在config/app.php里
如果访问 ?lang=ja-jp 却 fallback 到默认语言，八成是这个配置没对上。
最易被忽略的是：语言包文件里不能有任何 UTF-8 BOM 头，Windows 记事本保存极易引入，会导致整个文件解析失败，Lang::get() 返回空——建议统一用 VS Code 或 PHPStorm 保存为 “UTF-8 无 BOM” 格式。
