根本原因是语言包路径未注册或语言标识不匹配；需显式调用Lang::load()加载，自定义驱动须重写Lang类并绑定容器，命令行需手动设locale，模板缓存可能导致语言未更新。
多语言包文件没生效，Lang::get() 返回空字符串
根本原因通常是语言包路径没被正确注册进 think\lang\Lang 的加载队列，或者语言标识（如 zh-cn）和实际文件名/目录结构不匹配。ThinkPHP 默认只扫描 lang/ 下的固定目录（如 lang/zh-cn.php），不会自动识别你放在 app/lang/ 或按模块拆分的包。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 确认语言包是返回关联数组的 PHP 文件，且顶层键名与
Lang::get('key')中的key严格对应 - 用
Lang::load()显式加载自定义路径：Lang::load(app_path() . 'lang/zh-cn/admin.php'); - 如果要批量加载整个目录，需自己遍历
scandir()并逐个调用Lang::load()，框架不提供自动递归扫描 - 注意：多次调用
Lang::load()同一文件会覆盖而非合并，如有层级需求（如基础包 + 模块包），需手动控制加载顺序
想用数据库或 Redis 存语言项，怎么替换默认 File 驱动
ThinkPHP 的 Lang 类本身不支持驱动扩展，它硬编码依赖 think\lang\File 加载器。所谓“自定义 Lang 驱动”，其实是绕过原生 Lang，自己实现一套语言服务，并接管 Lang::get() 的行为——最稳妥的方式是重写 Lang 的静态方法，或直接在容器中绑定新实例。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 新建类
app\lang\DatabaseLang，实现get($name, $vars = [], $lang = null)方法，从数据库查lang_key、lang_value、lang_lang字段 - 在
app\common\service\LangService中封装缓存逻辑（比如先查 Redis，失效再查 DB） - 在
app\common\provider\AppServiceProvider的register()中，用$this->app->bind('think\lang\Lang', DatabaseLang::class)替换绑定 - 注意：原生
Lang::setLocale()不会触发你的数据库加载逻辑，必须在get()内部做 locale 判断和缓存 key 构造
Lang::get() 在命令行下返回空，但 Web 请求正常
这是因为命令行环境默认语言标识是 ''（空字符串），而 Web 环境通过请求头或配置自动设为 zh-cn 等值。当 Lang::get('hello') 执行时，它会去查当前 locale 对应的语言包，空 locale → 查 lang/.php → 找不到 → 返回空。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在命令行入口（如
command.php）开头强制设置：Lang::setLocale('zh-cn'); - 更健壮的做法是读取配置：
Lang::setLocale(config('app.default_lang', 'zh-cn')); - 避免在命令行中依赖未显式初始化的
Lang实例，尤其涉及多语言切换的定时任务 - 注意：
Lang的 locale 是静态属性，跨命令执行不会自动重置，若一个进程跑多个命令需手动清理或隔离
动态切换语言后，模板里 {:lang('xxx')} 还是旧内容
因为 {:lang('xxx')} 是模板编译后直接调用 Lang::get()，看似实时，但 ThinkPHP 模板引擎在首次编译时可能已将语言结果“固化”进缓存文件（尤其开启模板缓存时）。更常见的是：你在控制器里改了 Lang::setLocale()，但模板渲染发生在之后，而 Lang 内部状态没同步到视图上下文。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 关闭模板缓存调试：
'template' => ['cache' => false]，确认是否为缓存问题 - 确保
Lang::setLocale()在view()->fetch()之前调用，且没有中间件或钩子意外重置 locale - 不要依赖模板函数自动感知语言变化；更可控的方式是把翻译结果提前赋给
assign()变量，如$this->assign('title', lang('page_title')); - 注意：如果你用了自定义 Lang 类，必须确保
lang()辅助函数也指向你的新实现，否则模板里调的还是原生Lang::get()
