Lang::get()返回空字符串主因是语言包未加载或键名不匹配；需确认配置开启、路径格式正确（如lang/zh-cn.php）、嵌套结构一致，并用Lang::range()调试，避免BOM问题。
ThinkPHP 多语言切换时 Lang::get() 返回空字符串怎么办
核心原因通常是语言包未加载或键名不匹配，不是配置没生效，而是运行时根本没读到对应语言文件。
- 确认
app.lang_switch_on为true，且app.default_lang设为合法值（如'zh-cn'） - 语言包路径必须严格为
lang/zh-cn.php、lang/en-us.php，不能是zh_CN或zh—— ThinkPHP 只认短横线格式 -
Lang::get('user.name')要求语言包里是return ['user' => ['name' => '用户名']]，嵌套结构必须一致，平铺写法'user_name' => '用户名'会失效 - 调试时用
Lang::range()查看当前已加载的所有键值，比猜更直接
切换语言后 URL 不带 lang 参数，但又想保持用户偏好
ThinkPHP 默认不自动追加语言参数，靠 session 或 cookie 记住选择后，后续请求仍需手动触发语言设置，否则回退到默认语言。
- 在中间件里统一处理：读取
cookie.lang或session.lang，再调用Lang::setLocale($lang) - 不要依赖 URL 参数做唯一判断 —— 比如用户从分享链接进来没有
?lang=ja-jp，但 session 里有记录，此时应以 session 为准 - 注意
Lang::setLocale()必须在Lang类初始化之后调用，太早（如 config 加载阶段）会无效 - 如果用了路由分组（如
lang/:lang），记得在路由定义里把:lang值透传给Lang::setLocale()，别只存不设
多语言数据字段（如 title_zh / title_en）怎么自动适配模型输出
不能靠语言包硬翻译字段值，那是静态文案；动态内容得从数据库字段或 JSON 字段里按当前语言取值，属于数据层适配。
- 避免在控制器里写一堆
if ($lang === 'en') $data['title'] = $model->title_en;—— 把逻辑下沉到模型的获取器（accessor）里 - 定义 accessor 如
getTitleAttr，内部根据Lang::getLangSet()返回对应字段：return $this->getData('title_' . Lang::getLangSet()); - JSON 字段更灵活：存
{"zh-cn": "标题", "en-us": "Title"}，accessor 里用json_decode($this->content, true)[Lang::getLangSet()] ?? '' - 注意：关联模型、搜索条件、验证规则不会自动走 accessor，where 查询仍需显式写
title_zh或拼字段名
第三方扩展或插件的语言包不被自动加载
ThinkPHP 只扫描 lang/ 目录下的应用级语言包，vendor 里的扩展默认不参与自动加载流程。
立即学习“PHP免费学习笔记（深入）”；
- 手动加载：在
app/common.php或启动中间件中调用Lang::load($path)，路径需为绝对路径，例如Lang::load(EXTEND_PATH . 'somepkg/lang/zh-cn.php'); - 扩展作者应在
composer.json的autoload.files里声明语言包，但多数没这么做，所以得自己补 - 若扩展使用了独立命名空间（如
somepkg\Lang），别指望Lang::get()能跨命名空间访问 —— 它只认全局键名 - 冲突风险：两个扩展都定义了
'delete_confirm'，后加载的会覆盖前一个，建议加前缀如'somepkg.delete_confirm'
最易忽略的是语言包的编码和 BOM：UTF-8 with BOM 的 PHP 文件会导致 require 后输出不可见字符，Lang::get() 看似正常返回，实则字符串开头多了 \xEF\xBB\xBF，前端渲染就错位了。保存语言包时务必选 “UTF-8 无 BOM”。
