lang()在模板中失效的根本原因是模板引擎未加载语言包或加载时机晚于模板编译，需显式注册为模板函数、确保语言初始化在模板启动前完成，并注意变量传递语法差异。
多语言助手函数（如lang()）在模板中不生效，或与控制器中返回值不一致，根本原因不是翻译文件没写对，而是模板引擎未触发语言切换逻辑——它压根没加载语言包，或加载时机晚于模板编译。
模板里lang()返回空或原始键名
这是最常见现象：控制器中lang('user.name')能正确返回“用户名”，但模板里写{:lang('user.name')}却输出user.name或空字符串。
- 确认
lang()是否被注册为模板函数：ThinkPHP 6 默认不自动把助手函数注入模板上下文，lang()必须显式注册。检查config/template.php中'functions'配置项，确保包含'lang'：
'functions' => ['lang', 'url', 'dump', 'date'],
- 如果用了自定义视图驱动（如 Twig），
lang()更不会自动可用——必须手动注册为 Twig 函数，否则报Unknown "lang" function； - 语言包路径错误也会导致静默失败：确保语言文件放在
lang/zh-cn/（而非lang/zh_CN/），且文件名为common.php或对应分组名，例如user.php需配合lang('user.title')调用； - 别在
app/helper.php里重定义lang()函数——这会覆盖框架内置实现，导致多语言开关失效。
lang()在控制器有效、模板里无效的时序问题
模板编译发生在请求早期，而语言切换（如Lang::range('zh-cn')）若在中间件或控制器中才执行，模板早已完成解析，自然看不到切换效果。
- 语言初始化必须在模板引擎启动前完成，推荐位置是
app/common.php或app/provider.php中：
use think\facade\Lang;
Lang::range('zh-cn'); // 或从 cookie/session 动态读取
- 避免在中间件中调用
Lang::range()后，再进控制器改一次——模板只认第一次设置的语言范围； - 如果用了多应用模式，每个应用的语言配置要独立加载，
lang/目录需放在对应应用下（如app/api/lang/zh-cn/），不能只靠根目录lang/全局覆盖。
普通标签与XML标签中lang()行为差异
你在{:lang('submit')}里能取到翻译，但在{volist name="list" id="item"}{:lang($item.label)}{/volist}里却出错或返回空，这不是lang()的问题，是变量传递机制导致的。
立即学习“PHP免费学习笔记（深入）”；
-
$item.label这种带点语法在普通标签中会被模板引擎当字符串字面量处理，不会解析为变量，所以lang()实际接收的是字符串"$item.label"而非真实值； - 正确写法是用
name属性传参：{:lang($item['label'])}（数组访问）或提前在控制器 assign 一个已翻译的字段：view::assign('translated_labels', array_map('lang', $labels));； - XML 标签（如
{my:translate key="$item.code"}）若想支持动态键，其parseTranslate方法必须手动提取并执行lang($key)，不能依赖模板引擎自动展开变量。
真正容易被忽略的是：语言包加载和lang()函数注册是两件事，缺一不可；而模板编译时机远早于大多数业务逻辑，指望在控制器里切语言再渲染模板，基本等于白忙活。
