ThinkPHP语言切换必须在中间件handle()开头完成，因语言包在应用初始化阶段已加载，控制器中调用Lang::set()仅更新标识而不重载已缓存语言项。
ThinkPHP 的语言切换不是“设个参数就生效”，关键在于时机——语言包在应用初始化阶段就已加载，晚于这个时间点的任何设置（比如在控制器里调用 Lang::setLocale()）都只是改了个标识，不会重载验证提示、系统错误、模板默认文本等已缓存的语言项。
为什么在控制器里调 Lang::set() 没效果？
框架启动时，think\middleware\Lang 中间件会读取 Cookie 或 URL 参数，调用 Lang::detect() 确定语言，并立即加载 lang/{lang}/ 下的全部语言文件（包括 validate.php、common.php 等）。一旦加载完成，后续调用 Lang::set('en-us') 只会更新当前请求的语言上下文，但不会重新读取文件，也不会刷新已实例化的验证器、系统提示等。
- 典型现象：点按钮切英文，
lang('submit')显示对了，但表单验证失败时仍显示中文提示 - 根本原因：验证器类在控制器执行前就已初始化，其错误信息来自最初加载的语言包
- 正确做法：必须在中间件或
app\common.php中，在路由调度前完成语言判定与配置覆盖
域名绑定语言必须关掉 allow_url_lang
默认开启的 URL 语言参数（如 ?lang=ja-jp）优先级高于域名判断。如果你访问 ja.example.com 却看到中文，但加了 ?lang=en-us 就变英文，说明 URL 参数劫持了语言决策链。
- 在
config/app.php中明确设'allow_url_lang' => false - 不关它，哪怕你在中间件里手动
Config::set('lang.default_lang', 'ja-jp')，Lang::detect()仍会从$_GET['lang']拿值并覆盖你设的值 - 若业务真需 URL 切换，不要依赖默认逻辑，而是自定义一个
LangDetect类，重写detect()方法，让parse_url($_SERVER['HTTP_HOST'], PHP_URL_HOST)的结果优先于$_GET
中间件里动态设语言，注意 Host 解析细节
$_SERVER['HTTP_HOST'] 在本地开发或某些反代环境下可能带端口（如 localhost:8080），直接匹配域名映射数组会失败。
立即学习“PHP免费学习笔记（深入）”；
- 推荐用
$host = parse_url($_SERVER['HTTP_HOST'], PHP_URL_HOST) ?: $_SERVER['HTTP_HOST']清洗 - 域名映射配置建议单独抽成
config/lang_domains.php，内容如：['zh.example.com' => 'zh-cn', 'en.example.com' => 'en-us'] - 在中间件
handle()开头就执行：Config::set('lang.default_lang', $map[$host] ?? 'zh-cn') - 别忘了注册该中间件到
app/middleware.php，且确保它在SessionInit之后、路由之前
lang/ 目录结构错一个字母就静默失效
ThinkPHP 只认 lang/{lang_code}/ 这一固定路径格式，不接受别名、不自动 fallback、不报错提示。缺文件、大小写错、目录少一层，都会导致 Lang::get() 返回空或回退到默认语言。
- 必须严格按
lang/zh-cn/validate.php、lang/en-us/validate.php组织，不能是lang/zh_CN/或lang/zh-cn.php - 每个子目录下至少要有
common.php；验证语言包必须叫validate.php，否则验证器不读 - 修改后记得清空
runtime/lang/缓存目录，否则旧缓存会掩盖路径问题
最易被忽略的是语言包加载时机与验证器生命周期的耦合——你以为切了语言，其实验证器还在用启动时加载的老包。所有动态切换逻辑，必须卡死在中间件的 handle() 最开头，且确保配置写入早于任何类自动加载。
