ThinkPHP 6 的 lang() 不支持三级嵌套键名，需展平为一级键名或封装 lang_nested() 函数；语言包加载不自动继承未覆盖键，控制器级语言包作用域独立，且路径大小写必须严格匹配。
ThinkPHP 6 的 lang() 不支持三级嵌套键名
直接写 lang('user.profile.name') 会报错或返回空字符串——框架底层的 Lang 类只做一级数组查找，不解析点号分隔的嵌套路径。即使你语言包里定义了 ['user' => ['profile' => ['name' => '用户名']]]，lang() 也拿不到值。
常见错误现象：lang('user.profile.name') 输出空白，但 lang('user') 能正常返回整个子数组（如果存在），说明语言包加载成功，只是键名解析机制不支持嵌套。
- 必须把嵌套结构展平为一级键名，例如改用
'user_profile_name'或'user.profile.name'（作为纯字符串键，非路径） - 若坚持用点号风格，需自行封装解析逻辑，不能依赖原生
lang() - ThinkPHP 6.1+ 的
Lang::get()依然不支持递归取值，行为与lang()一致
模块/控制器级语言包如何叠加覆盖全局语言包
ThinkPHP 6 的语言包加载顺序是：框架默认 → 应用根目录 lang/ → 模块 app/lang/ → 控制器同名语言文件（如 app/index/lang/zh-cn/user.php）。后加载的会合并覆盖前者的同名键，但不会“继承”未覆盖的键。
也就是说，控制器级语言包不是“补丁”，而是独立作用域。如果你在 app/index/lang/zh-cn/user.php 里只写了 ['submit' => '提交']，那调用 lang('welcome') 时，它不会自动 fallback 到应用级的 welcome 值，而是返回空或触发未定义警告（取决于配置）。
立即学习“PHP免费学习笔记（深入）”；
- 确保关键通用文案（如
welcome、cancel）始终在应用级lang/zh-cn.php中定义 - 控制器级语言包建议只覆盖该控制器特有文案，避免重复定义全局键
- 调试时可用
Lang::all()查看当前已加载的全部键值对，确认是否被意外覆盖或遗漏
自定义嵌套语言包解析函数要避开 Lang::set() 的副作用
想实现 lang_nested('user.profile.name') 这类功能，最稳妥的方式是写一个独立函数，手动按点号拆分并逐层访问数组。但要注意：不要在函数里调用 Lang::set() 或修改 Lang::$lang 内部结构，否则可能污染后续 lang() 调用结果。
示例安全写法：
function lang_nested($key, $default = null) {
$lang = \think\facade\Lang::current();
$keys = explode('.', $key);
$value = $lang;
foreach ($keys as $k) {
if (!is_array($value) || !isset($value[$k])) {
return $default;
}
$value = $value[$k];
}
return $value;
}
// 使用：lang_nested('user.profile.name')
- 必须用
\think\facade\Lang::current()获取当前语言包数组，而非静态Lang::$lang（后者可能未初始化） - 不要在函数内调用
Lang::load()，避免重复加载或路径错乱 - 该函数不改变任何全局状态，可安全复用
多级目录语言包路径容易忽略大小写和命名规范
ThinkPHP 6 默认从 lang/{locale}/ 加载，但如果你手动指定路径（比如在中间件中调用 Lang::load()），路径中的 locale 名称必须严格匹配目录名。例如：zh-CN 和 zh-cn 是两个不同目录，而浏览器 Accept-Language 可能传 zh-CN，但你的目录叫 zh-cn，就会加载失败。
- 统一使用小写加短横线格式（如
zh-cn、en-us），避免大小写混用 - 检查
config/app.php中的default_lang和lang_list是否与实际目录名完全一致 - Linux 环境下路径区分大小写，CentOS 上尤其容易因命名不一致导致语言包静默失效
