lang() 返回空字符串或 null 的主因是语言包未加载、路径错误、键名不匹配或作用域失效；需检查路径、文件合法性、多应用显式指定、CLI 初始化、嵌套结构、变量格式及缓存刷新。
lang() 函数返回空字符串或 null 的常见原因
ThinkPHP6 的 lang() 函数查不到语言文本，大概率不是函数本身坏了，而是语言包没加载、路径不对、键名不匹配，或者多应用模式下作用域错了。
默认情况下，lang() 只会从当前应用（或默认应用）的 lang/zh-cn/ 目录下读取 PHP 数组文件，且要求文件名与控制器/方法名一致（如 index.php 对应 app/index/lang/zh-cn/index.php），否则直接跳过。
- 检查语言包是否放在正确路径：
app/lang/zh-cn/（全局）或app/index/lang/zh-cn/（模块级） - 确认语言包是合法 PHP 文件，返回关联数组，不能有语法错误或输出（如
echo、BOM 头） - 运行
php think lang:publish确保语言包已发布（尤其使用lang:publish命令生成时） - 多应用模式下，
lang()默认只加载当前应用的语言包；跨应用调用需显式指定，例如lang('user.login_fail', [], 'admin')
lang() 在命令行或中间件中失效
CLI 环境下 lang() 可能返回空，是因为请求上下文未初始化语言配置，或者 App::langSet() 没被触发。
TP6 的语言自动加载依赖 think\Request 和 think\App 的初始化流程，在命令行或某些中间件（如全局中间件早期阶段）里，语言包尚未载入。
立即学习“PHP免费学习笔记（深入）”；
- 手动设置语言：在命令行指令开头加
App::langSet('zh-cn') - 确保语言配置已加载：检查
config/lang.php中default_lang是否为有效值，且allow_lang_list包含该语言 - 避免在
initialize()之前调用lang()—— 比如在控制器构造函数里就用，可能早于语言初始化时机 - 调试时可用
Lang::load()主动加载指定文件，例如Lang::load(app_path() . 'lang/zh-cn/common.php')
lang() 键名嵌套和变量替换失败
像 lang('user.info.name') 这种点号嵌套写法，要求语言包是多维数组，且层级严格匹配；而 lang('hello :name', ['name' => 'Tom']) 的变量替换失败，往往是因为冒号后跟了空格或用了全角符号。
- 嵌套键必须对应数组结构：若语言包是
return ['user' => ['info' => ['name' => '用户名']]];，才能用lang('user.info.name') - 变量占位符必须为
:key格式（无空格、无引号、半角），: name或：name（全角冒号）都会失效 - 如果语言值本身含单引号，又用了
sprintf风格（如'%s is online'），注意不要和 TP 的变量替换机制冲突；建议统一用冒号语法 - 开启调试模式后，可查看日志中
Lang not found:开头的警告，它会明确打出缺失的键名
多语言切换后 lang() 不刷新内容
调用 Lang::setLocale('en-us') 后 lang() 仍返回旧语言内容，说明语言包已缓存，或切换时机太晚（比如在模板渲染之后才切）。
- 语言切换必须在所有
lang()调用前完成，推荐在中间件handle()开头或控制器initialize()中设置 - TP6 默认启用语言包缓存（
lang_cache_time > 0），修改语言包后需清空runtime/lang/目录，或设lang_cache_time => 0（开发环境） - 不要依赖 Cookie 或 Session 自动识别语言后再调用
lang()—— 必须确保Lang::detect()已执行且结果已生效 - 验证当前语言：打印
Lang::getLangSet()，而不是只看 URL 参数或 Cookie 值
最常被忽略的是语言包路径和命名的隐式规则：TP6 不会报错提示“找不到文件”，而是静默跳过。盯住 runtime/log/ 里的 warning 日志，比反复改代码更省时间。
