ThinkPHP6多语言不生效是因为Lang类惰性加载，需在路由调度前调用Lang::setLocale()或Lang::detect()显式初始化，仅配置app.lang无效。
ThinkPHP 默认语言不是靠 config/app.php 里写死的，而是由系统自动探测 + 配置项共同决定的；不显式初始化 Lang 类或调用 Lang::detect()，多语言不会生效。
为什么 app.lang 配置不生效？
很多人在 config/app.php 中设置了 'default_lang' => 'zh-cn'，但 lang() 函数仍返回英文或空字符串。这是因为：
- ThinkPHP 6+ 的多语言组件默认是“惰性加载”，不主动触发就不会读取语言包
-
app.lang只是兜底值，真正起作用的是Lang类的当前语言状态 - 控制器/中间件中未调用
Lang::setLocale('zh-cn')或未开启自动检测，Lang::getLangSet()就会 fallback 到en-us
怎样正确初始化多语言（TP6/TP8）？
推荐在应用启动阶段统一初始化，而不是每个控制器里重复判断。最稳妥的位置是 app/middleware.php 或自定义中间件：
// app/middleware.php
use think\facade\Lang;
// 强制设为中文（跳过浏览器检测）
Lang::setLocale('zh-cn');
// 或启用自动检测（按 HTTP Accept-Language 头 + session + cookie 顺序匹配）
Lang::detect();
- 必须在路由调度前执行，否则控制器中
lang('user.name')可能拿不到翻译 - 若使用
Lang::detect()，需确保config/lang.php中的'allow_lang_list'包含目标语言，例如['zh-cn', 'en-us'] - 语言包目录必须严格为
lang/zh-cn/（小写、短横线），不能是zh_CN或zhcn
lang() 函数没反应？检查这三处
常见现象：调用 lang('user.login') 返回原 key 字符串，而非翻译内容。优先排查：
立即学习“PHP免费学习笔记（深入）”；
- 对应语言包文件是否存在且路径正确：
lang/zh-cn/common.php中是否定义了'user.login' => '用户登录' - 语言包是否被正确加载：在调试模式下查看日志，搜索
Lang: load lang file是否出现成功提示 - 是否误用了
Lang::get()而非lang()—— 前者只查当前 locale 下已加载的 key，后者会自动触发加载和 fallback
切换语言时 session 和 cookie 怎么同步？
手动切换语言（如用户点“English”按钮）时，仅调用 Lang::setLocale('en-us') 不够，还需持久化选择：
// 切换后保存到 session 和 cookie（便于下次访问自动识别）
session('think_lang', 'en-us');
cookie('think_lang', 'en-us', 3600);
Lang::setLocale('en-us');
- cookie 名默认是
think_lang，可在config/lang.php中通过'var_lang' => 'lang'自定义 - 注意：如果同时启用了
Lang::detect()，它会优先读 cookie → session → header，所以 cookie 设置必须在 detect 之前完成 - TP8 中
Lang::setLocale()不再自动写 cookie/session，必须显式调用
多语言真正的坑不在配置，而在加载时机和上下文隔离——比如命令行环境没有 HTTP 头，Lang::detect() 会直接 fallback；又比如单元测试中未重置 Lang 状态，会导致测试污染。初始化逻辑一旦写错，后续所有 lang() 调用都不可信。
