Thinkphp6模板多语言标签不解析修复方法-ThinkPHP-PHP中文网

lang('welcome')只显示键名说明语言包未加载成功，主因是语言包路径错误或中间件loadlangpack未启用，需先在控制器中验证lang::get()是否正常工作。

thinkphp6模板多语言标签不解析修复方法

模板里写 lang('welcome') 不出翻译、只显示键名，说明语言包根本没加载成功，不是语法或缓存问题。

Lang::get() 在模板中失效的常见原因

ThinkPHP6 模板引擎本身不解析 lang() 函数调用，它只是原样输出——真正起作用的是 PHP 解析器在执行模板时运行该函数。所以“不解析”本质是函数执行失败或返回了键名本身。

最常见：语言包路径错误，app/lang/zh-cn.php 不存在或命名是 zh_CN.php（框架会转成小写连字符，但文件系统大小写敏感，Linux 下 zh-CN.php 和 zh-cn.php 是两个文件）
次常见：中间件未启用，think\middleware\LoadLangPack 没加进 app/middleware.php，导致整个语言包加载流程被跳过
容易忽略：模板被缓存且缓存未更新，但更大概率是首次访问就失效，说明不是缓存问题而是加载链断裂
危险信号：如果 Lang::get('welcome') 在控制器里也返回 welcome，那基本可确认语言包完全没加载；如果控制器里正常、模板里异常，则可能是模板编译后未重新生成（删 runtime/view/ 目录即可）

检查 Lang::get() 是否真能工作

别信模板，先在控制器里硬测：

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

public function index()
{
    dump(Lang::getLangSet()); // 应输出 'zh-cn' 或 'en-us'
    dump(lang('welcome'));     // 应输出翻译值，不是 'welcome'
    dump(file_exists(app()->getLangPath() . 'zh-cn.php')); // 确认路径存在
    return view();
}

如果 Lang::getLangSet() 返回空或 default_lang 配置值但没变，说明语言侦测失败 → 检查 config/lang.php 中 'detect_var' => 'lang' 和 'allow_lang_list' 是否配置，以及请求是否带 ?lang=zh-cn
如果 lang('welcome') 返回键名，但文件存在 → 检查 zh-cn.php 是否以 return ['welcome' => '欢迎']; 形式返回，开头不能有 BOM、空格、echo 或 UTF-8 签名
如果 file_exists() 返回 false → 路径拼错了，确认 app()->getLangPath() 输出的是 /var/www/html/app/lang/ 这类绝对路径，不是相对路径

模板中 lang() 不生效的修复动作

确认函数本身可用后，再聚焦模板场景：

确保模板文件后缀是 .php（不是 .html），否则不会被 PHP 解析器执行
避免在模板里写 <?php lang('welcome'); ?> 却不 echo —— 正确写法是 = lang('welcome') ?> 或 <?php echo lang('welcome'); ?>
不要在模板里调用 Lang::setLocale() 后立刻用 lang()，因为语言包已加载完毕，setLocale() 不会触发重载；如需动态切语言，应在控制器或中间件里完成
多应用模式下，模板语言包路径应为 app/应用名/lang/zh-cn.php，不是 app/lang/；若用 app/index/lang/zh-cn.php，则需在 config/lang.php 中设置 'path' => app_path('index/lang')