ThinkPHP语言切换必须在语言包加载前完成，否则Lang::setLang()仅影响后续新调用，对已载入的验证器、模板等无效；需在全局中间件handle()开头或app\common.php中设置，禁用allow_url_lang并规范域名映射与cookie键名。
ThinkPHP 的语言切换不是“设个变量就生效”，必须在语言包加载前完成语言标识设置，否则整个请求周期内都用默认语言——哪怕你中间调了 Lang::setLang('en-us')，模板、验证器、系统提示也早已按旧语言渲染完了。
Lang::setLang() 必须在请求最开始调用
框架在应用初始化阶段就加载了默认语言包，Lang::setLang() 只影响后续新触发的 lang() 调用，对已载入的语言项（比如验证规则 validate.php、系统提示 common.php）完全无效。
- 正确位置：全局中间件的
handle()开头，或app\common.php中（确保早于路由和控制器执行） - 错误位置：控制器方法里、模板中、AJAX 接口内部
- 典型现象：
lang('submit')切换成功，但表单验证错误信息仍是中文——因为Validate类初始化时语言包已固定
域名切换语言必须禁用 allow_url_lang
默认开启的 URL 参数识别（?lang=en-us）优先级高于域名判断，会导致 en.example.com 仍显示中文，除非手动加参数覆盖。
- 关闭方式：在
config/app.php中设'allow_url_lang' => false - 域名映射建议单独抽成配置文件，如
config/lang_domains.php：['en.example.com' => 'en-us', 'zh.example.com' => 'zh-cn'] - 注意
$_SERVER['HTTP_HOST']可能带端口（如localhost:8080），要用parse_url($host, PHP_URL_HOST)清洗后再匹配
Cookie 切换只认 think_lang 这个键名
Lang 中间件默认只读 $_COOKIE['think_lang']，写成 lang、language 或手写 setcookie() 都不会被识别。
立即学习“PHP免费学习笔记（深入）”；
- 前端 JS 切换时，必须用
document.cookie = "think_lang=en-us; path=/;" - 后端 PHP 写入统一用
cookie('think_lang', 'en-us')，别漏掉path和domain一致性 - 中间件读取是一次性的：请求进来时读一次，之后改
$_COOKIE数组无效
语言包路径大小写敏感且结构固定
ThinkPHP 严格按 lang/{lang}/common.php 路径加载，目录名必须全小写，文件名不能是 Common.php 或 EN-US.php，否则静默失败——lang() 直接返回原 key 字符串，不报错也不警告。
- 正确路径：
lang/zh-cn/common.php✔️，lang/en-us/validate.php✔️ - 错误路径：
lang/ZH-CN/common.php❌，lang/en-us.php❌，lang/en-us/lang.php❌ - 缺失文件时行为：
lang/en-us/common.php存在但lang/en-us/validate.php缺失 → 验证提示仍用默认语言，无任何提示
最容易被忽略的是语言包加载时机与作用域：它不是“全局变量式”的切换，而是一次性上下文绑定。一旦错过初始化窗口，再怎么调 Lang::setLang() 或写 Cookie，都只能影响后续新增的翻译调用，无法刷新已渲染内容。
