lang::get() 返回空或原key是因语言包未加载或键名结构不匹配；用lang::range()确认加载状态与键存在性，检查路径、命名、嵌套层级、分组文件位置及locale切换时机，动态内容需独立多语言处理。
Lang::get() 返回空字符串或原 key，不是配置没生效，而是运行时根本没加载到对应语言包，或者键名结构不匹配。
查语言包是否真被加载了
别猜路径对不对，直接用 Lang::range() 看当前已加载的所有翻译项。它返回一个完整数组，一眼就能确认：user.name 在不在里面、值是不是你预期的字符串。
- 如果
Lang::range()返回空数组，说明语言包压根没加载——检查lang/zh-cn.php路径是否存在、是否是小写短横线格式（zh-cn≠zh_CN）、文件是否以return ['key' => 'val'];结尾（不能有 BOM、不能是 JSON） - 如果
Lang::range()有内容但缺某个 key，说明该 key 没写进语言包，或者写在了错误分组（比如你调用的是Lang::get('login.title')，但语言包里只写了['title' => '登录']，没嵌套在login下） - Linux 服务器上注意目录名大小写，
Lang/zh-CN/和lang/zh-cn/是两个不同路径，ThinkPHP 只认后者
查键名嵌套结构是否一致
Lang::get('user.profile.name') 要求语言包里必须是三层嵌套：return ['user' => ['profile' => ['name' => '用户名']]];。平铺写法如 'user_profile_name' => '用户名' 不会命中。
- 嵌套层级必须和
Lang::get()的点号路径完全对齐，多一层、少一层、拼错字母都会失效 - 不要依赖 IDE 自动补全来判断键是否存在——补全是基于 PHP 文件结构，不是运行时加载的语言包
- 如果用了分组（比如
Lang::get('user.login', '', 'user')），要确认语言包文件是lang/zh-cn/user.php，且函数第二个参数传的是空字符串而非null
查切换逻辑是否在请求早期执行
语言设置必须在控制器执行前完成，否则 Lang::get() 拿到的是旧 locale 下加载的内容，切换后不会自动重载已缓存的翻译项。
- 在中间件（如
app/middleware/LangSwitch.php）里调用Lang::setLocale($lang)，并确保该中间件排在路由解析之后、控制器执行之前 - 如果用了路由分组（如
lang/:lang），记得从$request->param('lang')取值并透传给Lang::setLocale()，不能只存到 Session 或 Cookie 就不管了 - 避免在控制器构造函数里设 locale——此时语言包可能已按默认语言加载完毕，后续调用
Lang::get()仍走旧缓存
查动态内容是否误用静态翻译
字段值（如数据库里的 title、content）不是靠 Lang::get() 翻译的，那是静态文案。动态内容得从数据层按当前语言取值。
- 别在 where 条件里写
where('title', lang('article.title'))——这查的是翻译后的字符串，不是原始字段 - 推荐用 JSON 字段存多语言值：
{"zh-cn": "标题", "en-us": "Title"}，再通过 accessor 解析：json_decode($this->title_json, true)[Lang::getLangSet()] ?? '' - 关联查询、搜索条件、验证规则不会自动走 accessor，
where还得显式写title_zh或拼字段名，不能指望Lang::get()替你做字段映射
最容易被忽略的是：语言包加载是一次性的，切 locale 不等于重载文件；而动态字段的多语言适配，跟 Lang::get() 完全是两套机制，混用就会漏翻。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
