Lang::get()返回空字符串或原始键名，主因是键名不匹配或语言包未加载；需确认语言包为扁平结构、键名合法、路径正确，并用Lang::has()调试而非硬编码fallback。
多语言键名不匹配时，Lang::get() 返回空字符串或原始键名
这是最常见现象：明明在语言包里写了 'user.login' => '登录'，但调用 Lang::get('user.login') 却返回 'user.login' 或空字符串。根本原因不是语法写错，而是 ThinkPHP 默认只加载 lang/zh-cn.php 这类扁平文件，不自动识别嵌套数组结构。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 确认语言包是否为纯关联数组（不能是多维嵌套）：ThinkPHP 6.x 的
Lang::get()仅支持点号分隔的扁平键名，不解析 PHP 数组层级 - 如果用了嵌套写法（如
return ['user' => ['login' => '登录']]），必须改用Lang::parse()手动展开，或重构为扁平格式 - 检查
app.lang_switch_on是否为true，且当前请求已正确设置语言（如通过Lang::setLocale('zh-cn')） - 调试时直接 dump
Lang::getLangSet()，看实际加载进内存的语言项是否包含目标键
想用嵌套结构组织语言包？必须手动 Lang::parse() 或改用配置式加载
ThinkPHP 原生不支持类似 Laravel 的嵌套语言数组自动映射。若坚持用嵌套结构（比如按模块分组），就得绕过默认加载流程。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 把嵌套语言包存为独立配置文件（如
config/lang/user.php），用Config::load()加载，再用array_merge_recursive()合并到语言池 - 或在
AppService::boot()中调用Lang::parse($langArray)显式展开嵌套数组（$langArray必须是完整二维以上结构） - 注意
Lang::parse()不会覆盖已有键，重复键名会被后加载的覆盖，顺序很重要 - 避免在控制器里反复调用
Lang::parse()，应放在应用初始化阶段一次性处理
Lang::get() 查不到键时，优先查 Lang::has() 而不是硬编码 fallback
很多人写成 Lang::get('xxx') ?: '默认文案'，看似稳妥，实则掩盖了键名未加载的根本问题——比如拼写错误、语言包路径错位、缓存未更新。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 开发期开启
app.debug = true，配合Lang::has('user.login')判断是否存在，不存在时抛出throw new Exception("Missing lang key: user.login") - 语言包文件名必须与
Lang::setLocale()设置的值完全一致（如zh-cn.php对应zh-cn，不能是zh_CN） - 修改语言包后记得清空
runtime/lang/缓存目录，否则旧键仍可能被命中 - CLI 环境下
Lang不自动加载，需显式调用Lang::load()
中文键名或带空格的键名会导致 Lang::get() 失效
ThinkPHP 内部对键名做了简单校验，非字母、数字、下划线、点号的字符（如中文、短横线、括号）会被过滤或截断，导致匹配失败。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 严格使用英文+点号+下划线组合键名，例如用
'user.form.title'代替'用户表单标题' - 如果 UI 层必须显示中文键（如低代码平台），应在前端做映射，后端语言包保持英文键
- 不要用
-（短横线）分隔单词，ThinkPHP 会把它当减法运算符处理；统一用_或. - 运行时可通过
Lang::getLangSet()输出全部键名，快速发现非法字符引发的截断问题
