必须在App初始化阶段设置语言标识，因Lang类加载后语言包已固化，后续Lang::setLocale()无效；需在中间件首位用DomainLangMiddleware根据域名映射配置Config::set('lang.default_lang', $lang)，并关闭allow_url_lang、清理缓存、禁用cookie覆盖。
域名切换语言包在 ThinkPHP 中无法自动生效，必须在请求生命周期最早期（App 初始化阶段）完成语言标识设置，否则验证器提示、系统错误、模板渲染等环节已加载默认语言包，后续任何 Lang::setLocale() 或 Config::set('lang.default_lang', ...) 都是无效的。
为什么 Lang::setLocale() 在域名切换后不生效
框架启动时就完成了语言包加载流程：Lang 类实例化 → 读取 default_lang → 加载 lang/zh-cn/ 下所有文件（如 validate.php、common.php）。此时语言上下文已固化。而 Lang::setLocale('en-us') 只影响之后新调用的 Lang::get()，对早已载入的验证规则提示（如 ['required' => ':attribute不能为空']）完全无感。
- 典型现象：访问
en.example.com，但表单验证仍显示中文“用户名不能为空” - 根本原因：验证器类在控制器执行前就初始化完毕，其错误消息来自已加载的语言包
- 解决路径只有一条：让语言选择逻辑发生在
Lang类首次加载之前
如何在 app/middleware.php 中安全实现域名映射
必须把语言判断逻辑放在全局中间件最开头，并确保它早于 think\middleware\Lang 执行。推荐新建一个 DomainLangMiddleware 放在中间件数组首位。
- 读取域名用
parse_url($_SERVER['HTTP_HOST'], PHP_URL_HOST)，避免端口干扰（如localhost:8080） - 映射配置建议单独抽成
config/lang_domains.php，内容为['zh.example.com' => 'zh-cn', 'en.example.com' => 'en-us'] - 设置语言必须用
Config::set('lang.default_lang', $lang)，不是Lang::set()—— 后者不改配置，只改运行时状态 - 务必关闭 URL 语言参数干扰：
'allow_url_lang' => false（在config/app.php中）
lang/ 目录结构与大小写陷阱
ThinkPHP 对语言包路径极其敏感，大小写错误或层级错位会导致静默失败（不报错，只回退到默认语言）。
立即学习“PHP免费学习笔记（深入）”；
- 正确路径：
lang/zh-cn/validate.php、lang/en-us/common.php—— 语言代码必须小写，连字符分隔 - 错误路径：
lang/ZH-CN/、lang/zh_CN/、lang/zh-cn/Validate.php（首字母大写） - 若启用分组（如模块级语言），最多支持两级：
lang/zh-cn/admin/✔️，lang/zh-cn/admin/user/❌（第三级被忽略） - 每个语言子目录下至少要有
common.php，否则Lang::get('submit')会返回空字符串
批量替换语言包时最容易漏掉的三件事
从 zh-cn 迁移到多域名支持，光复制文件远远不够。
- 没清缓存：
runtime/lang/下的编译缓存不会自动更新，必须手动删掉或执行php think clear:lang - 没关 Cookie 自动覆盖：如果
use_cookie为 true，且用户本地有think_lang=zh-cn，它会强行覆盖域名判断结果 - 没检查扩展包路径：若在
config/lang.php的extend_list中硬编码了绝对路径（如app()->getBasePath() . 'lang/zh-cn.php'），域名切换后该路径不会动态变化，导致扩展语言包始终加载旧版本
真正起效的语言切换，永远发生在框架加载语言包之前；一旦错过那个时间点，所有补救都是徒劳的。
