域名切换语言包必须在框架加载语言资源前完成，否则Lang::setLocale()等后续操作无效；根本原因是语言包在应用初始化阶段已一次性加载，验证器等静态内容绑定默认语言；正确时机是middleware.php的handle()开头或provider.php注册服务前；需通过Config::set('lang.default_lang', $lang)设置，并确保语言包路径严格匹配如lang/zh-cn/。
域名切换语言包必须在框架加载语言资源前完成，否则所有语言项（包括验证提示、系统错误、模板变量）都会按默认语言渲染，后续任何 Lang::setLocale() 或 cookie('think_lang') 都无效。
为什么 Lang::setLocale() 在控制器里调用没反应
因为 ThinkPHP 的语言包是在应用初始化阶段（think\App::init() 之后、路由调度之前）一次性加载的。控制器执行时，validate.php、common.php 等语言文件早已载入内存，Lang::setLocale('en-us') 只影响此后新调用的 L()，对已加载的验证器提示、系统异常消息完全不起作用。
- 典型表现：访问
en.example.com，但throw_exception(L('VALIDATE_ERROR'))仍输出中文 - 根本原因：验证器类在控制器实例化前就完成了静态初始化，其提示语句已绑定到默认语言上下文
- 正确时机：必须在
app/middleware.php全局中间件的handle()开头，或app/provider.php中注册服务前完成语言设置
如何让域名自动映射到语言包目录
ThinkPHP 默认不解析域名，需手动根据 $_SERVER['HTTP_HOST'] 匹配配置并覆盖 lang.default_lang。注意端口干扰和大小写问题。
- 先清理 Host：用
parse_url($_SERVER['HTTP_HOST'], PHP_URL_HOST)去掉:8080类端口，避免localhost:8080匹配失败 - 域名映射建议放
config/lang_domains.php：返回数组如['zh.example.com' => 'zh-cn', 'en.example.com' => 'en-us'] - 在中间件中调用：
Config::set('lang.default_lang', $map[$host] ?? 'zh-cn')，别用Lang::set()—— 它不改默认语言配置 - 路径必须严格对应：语言包得放在
lang/zh-cn/和lang/en-us/下，不是lang/zh_CN/或lang/zh/，大小写错就静默跳过
allow_url_lang 开启后域名切换为什么会失效
开启 'allow_url_lang' => true 后，ThinkPHP 会在 CheckLangBehavior 中优先读取 $_GET['l']（或你设的 VAR_LANGUAGE），一旦 URL 中有该参数，域名逻辑直接被跳过。
立即学习“PHP免费学习笔记（深入）”；
- 现象：访问
ja.example.com?l=zh-cn显示中文，删掉?l=zh-cn却还是中文——说明 Cookie 里存了旧值，且 URL 参数劫持了判断链 - 解决方式一（推荐）：在
config/app.php中设'allow_url_lang' => false，彻底关闭 GET 干预 - 解决方式二（保留 URL 切换）：重写
think\lang\Detect，把域名匹配逻辑提到$_GET之前，并确保Config::set('lang.default_lang', ...)在 Detect 执行前已完成 - 注意：关掉后
Lang::get()不再自动识别$_GET['l']，前端切换需走cookie('think_lang', 'en-us')或 Session
Lang 中间件注册了但语言包还是没加载
think\middleware\Lang 中间件默认不启用，即使写了类也等于没装。它只负责读 Cookie 并调 Lang::set()，不负责加载语言文件；而语言文件加载由 CheckLangBehavior（TP3.2）或 LangMiddleware 自身触发（TP6+），前提是中间件已激活且顺序正确。
- 检查
app/middleware.php是否包含未注释的think\middleware\Lang::class - 确认中间件顺序：必须在
SessionInit之后、RouteCheck之前，否则读不到$_COOKIE['think_lang'] - Cookie 键名必须是
think_lang，不是lang或language；写入时用cookie('think_lang', 'en-us', 3600)，别手写setcookie() - 如果用了多应用模式，每个应用的
middleware.php都要单独配，主应用的配置不继承给子应用
最易忽略的是语言包加载时机与中间件执行顺序的耦合关系：哪怕域名解析逻辑完全正确，只要晚于 LangMiddleware 执行，或者中间件本身没注册，整个链条就断在第一步。调试时优先 dump Config::get('lang.default_lang') 和 Lang::getLangSet()，而不是直接看页面输出。
