ThinkPHP多语言切换必须使用think_lang Cookie键，Lang中间件需手动注册且顺序在SessionInit后、路由前，语言包路径须全小写，Lang::set()不持久化需同步写cookie。
ThinkPHP 的多语言切换必须靠 think_lang 这个固定 Cookie 键来驱动，设成 lang 或 language 都无效——Lang 中间件压根不认。
Lang 中间件没生效？先查注册和顺序
Lang 中间件默认不启用，必须手动注册。打开 app/middleware.php，确认 think\middleware\Lang 在数组里且未被注释。多应用模式下，每个应用的 middleware.php 都得单独配。
中间件执行顺序很关键：Lang 必须在 SessionInit 之后、路由调度之前。否则 $_COOKIE['think_lang'] 读不到，Lang::detect() 拿不到上下文，语言包加载直接跳过。
- 常见错误现象：
Lang::get('hello')始终返回英文，但控制台无报错 - 调试方法：在控制器开头加
var_dump($_COOKIE['think_lang']);，看是否为空 - 如果为空，说明中间件根本没跑，或 Cookie 键名/路径/域名不匹配
Cookie 怎么写才被 Lang 中间件识别
Lang 中间件只在请求初始化阶段读一次 $_COOKIE['think_lang']，后续改 $_COOKIE 数组完全无效。所以不能靠前端手写 document.cookie = "lang=zh-cn"，必须用框架方式写对键名和作用域。
立即学习“PHP免费学习笔记（深入）”；
- 推荐写法：
cookie('think_lang', 'zh-cn', ['expire' => 86400, 'path' => '/', 'domain' => '.yourdomain.com']) - 如果必须前端写，确保键名是
think_lang，且path和domain与后端配置一致（比如后端设了domain => '.example.com'，前端也得写domain=.example.com） - 别用
setcookie()手动写——容易漏secure/httponly，还可能被框架配置覆盖
语言包目录结构和加载失败静默问题
ThinkPHP 按 lang/{lang}/ 目录结构加载语言包，不是按文件名，也不是按 config/lang.php 里的别名。路径错、大小写错、缺文件，都会静默失败——Lang::get() 回退到默认语言，不报错也不提示。
- 正确路径示例：
lang/zh-cn/common.php✔️；lang/ZH-CN/common.php❌（必须小写） - 常见错误：
Lang::set('ja-jp')后发现Lang::get('submit')还是英文，实际是lang/ja-jp/下没有common.php或拼写为commom.php - 验证方法：在控制器里调
Lang::load('common', 'zh-cn')，返回true表示加载成功，false就说明路径或文件有问题
Lang::set() 和 Cookie 持久化的关系
Lang::set('en-us') 只改当前请求的语言上下文，它不写 Cookie，也不会触发 Lang 中间件重载。要让下次请求也生效，必须自己同步写 Cookie。
- 切换语言时，两步不能少：
Lang::set('ja-jp')+cookie('think_lang', 'ja-jp', [...]) - 如果只调
Lang::set()，页面刷新后立刻回退到默认语言 - Cookie 配置中的
secure和httponly必须和站点部署环境匹配：HTTPS 站点必须设'secure' => true，反向代理后还要在config/app.php里显式声明'https' => true，否则检测不到 HTTPS 会自动禁用secure
最常被忽略的是：Lang 中间件只读一次 Cookie，且只认 think_lang；语言包路径必须全小写；Lang::set() 不等于持久化——这三处出错，调试时几乎看不到任何线索。
