如何设置ThinkPHP多语言回退机制及默认语言配置方法？

本文共计872个文字，预计阅读时间需要4分钟。

简单修改如下：

lang() 函数不报错但返回原文，怎么确认真失效了

这不是配置没起作用，而是运行时根本没加载到对应语言包，或 key 名拼写/嵌套结构不一致。常见表现：lang('user.name') 返回 'user.name'，而不是 '用户名'。

• 先用 Lang::range() 查看当前已加载的所有翻译项，确认目标 key 是否在列表里
• 检查语言包路径是否为 lang/zh-cn.php（不是 zh_CN.php 或 zh-cn/common.php）
• 确认 app.lang_switch_on === true 且 app.default_lang 是合法小写短横线格式（如 'zh-cn'）
• 如果用了嵌套键（如 'user.name'），语言包必须是嵌套数组：return ['user' => ['name' => '用户名']]，平铺写法 'user_name' => '用户名' 会失效
• 检查文件是否有 BOM 头——PHP 读取时可能静默失败，导致整个文件未被解析

缺省语言兜底逻辑在哪配、怎么触发

ThinkPHP 没有“二级语言包”或“fallback lang”配置项，兜底行为是隐式发生的：当当前语言包中找不到 key 时，自动回退到 default_lang 对应的语言包再查一次。