TP5的common.php中不能直接调用lang()，因其加载早于语言环境初始化；应使用L()函数，但需确保lang_switch_on为true、allow_lang_list包含当前语言、语言包路径为application/lang/zh-cn.php且文件合法。
TP5 的 common.php 里不能直接写 lang()
ThinkPHP 5.x 的 application/common.php 是全局函数文件，加载时机早于语言包初始化，此时 lang() 函数尚未可用，也未设置语言环境。直接在里面调用 lang('xxx') 会报错或返回原 key 字符串。
常见错误现象：页面空白、Call to undefined function lang()、或输出 'login_failed' 而非翻译内容。
- TP5 中真正可用的语言函数是
L()（lang()是 TP6+ 主推，TP5 不原生支持） -
L()在 TP5 中是全局函数，无需提前 setLang，但依赖lang_switch_on => true和自动探测机制 -
common.php可安全使用L()，前提是语言配置已生效且语言包路径正确
TP5 的 common.php 多语言写法示例
在 application/common.php 中定义带语言支持的辅助函数时，应封装 L() 调用，而非硬编码中文：
function show_status($code) {
$map = [
'success' => L('operation_success'),
'fail' => L('operation_failed'),
'pending' => L('pending_review'),
];
return $map[$code] ?? L('unknown_status');
}
对应语言包需存在：application/lang/zh-cn.php（或 zh-cn/common.php，取决于 TP5 版本和配置），内容为：
<?php
return [
'operation_success' => '操作成功',
'operation_failed' => '操作失败',
'pending_review' => '待审核',
'unknown_status' => '未知状态',
];
为什么 common.php 里用 L() 有时仍不生效
即使写了 L()，也可能静默返回原 key —— 这不是函数问题，而是环境没就位：
-
lang_switch_on必须为true，且在config.php或模块配置中启用 -
default_lang和allow_lang_list需显式配置，例如：'allow_lang_list' => ['zh-cn', 'en-us'] - 语言包路径必须是
application/lang/zh-cn.php（TP5.0/5.1 常用单文件模式）或application/lang/zh-cn/common.php（部分定制版），注意大小写 - TP5 默认不自动加载
common.php中的语言包，L()会在首次调用时尝试按当前检测到的语言码加载，若路径错或文件不存在，就 fallback 到原字符串
更稳妥的替代方案：把多语言逻辑移到中间件或基类
如果 common.php 中需要强依赖翻译结果（比如日志文案、异常提示），建议移出该文件，改用以下方式：
- 在控制器基类
Base的initialize()方法中调用L()，确保语言环境已就绪 - 自定义一个
LangHelper类，在app/common.php中仅引入类，不在函数体里执行L() - 避免在
common.php中做条件判断后直接 echoL()—— 输出已开始时再翻译，容易破坏 header 流程
最易被忽略的一点：TP5 的 L() 不校验 key 是否真实存在，缺失时永远静默回退，上线前务必用脚本扫描语言包键名一致性。
