Lang中间件未生效的四大原因：未注册到全局中间件栈；Cookie键名非think_lang或路径/域名不一致；语言包路径大小写错误或缺少common.php；Lang::set()与Cookie不同步且调用时机不当。
Lang中间件没生效？检查是否注册到全局中间件栈
ThinkPHP的Lang中间件不会自动启用，必须显式注册。不注册就等于没写——语言包压根不会加载，Lang::get()返回空或默认值，但控制台也不报错，非常隐蔽。
实操建议：
- 打开
app/middleware.php，确认think\middleware\Lang在数组中（不是注释掉） - 若用多应用模式，需在对应应用的
middleware.php里单独配置 - 中间件顺序有影响：它必须在
SessionInit之后、路由调度之前执行，否则Cookie读不到或Lang::detect()拿不到上下文
Cookie语言标识没被识别？确认键名和解析时机
ThinkPHP默认只认think_lang这个Cookie键，不是lang、也不是language。设错就白设，请求进来时Lang中间件直接跳过切换逻辑。
常见错误现象：
立即学习“PHP免费学习笔记（深入）”；
- 前端用
document.cookie = "lang=zh-cn"写了，但Lang::get('hello')还是英文 -
$_COOKIE['think_lang']为空，但$_COOKIE['lang']有值
解决方法：
- 写
Cookie时用cookie('think_lang', 'zh-cn')，别手写setcookie() - 如果必须前端写，确保键名是
think_lang，且路径（path）和域名（domain）与后端一致 -
Lang中间件只在HTTP请求初始化阶段读一次Cookie，后续手动改$_COOKIE无效
动态切换语言包失败？注意语言包路径和命名规范
ThinkPHP按lang/{lang}/目录结构加载语言包，不是按文件名、也不是按config/lang.php里配的别名。包里缺文件、路径错位、大小写不一致，都会静默失败。
使用场景举例：用户点按钮切日语，你调Lang::set('ja-jp')，但lang/ja-jp/下没有common.php，那Lang::get('submit')就回退到默认语言，不报错也不提示。
关键检查点：
- 语言包目录必须小写：
lang/zh-cn/✔️，lang/ZH-CN/❌ - 每个语言子目录下至少要有
common.php，内容为return ['key' => 'value']; - 如果用模块化语言包（如
admin/common.php），需确保Lang::load()时指定模块名，或开启lang_auto_load配置 -
Lang::set()只改当前请求的语言标识，不改变Cookie，要持久化得自己调cookie('think_lang', $lang)
Lang::set() 和 Cookie 冲突？优先级和覆盖时机要理清
Lang::set('en-us')会立刻覆盖当前请求的语言上下文，但它不写Cookie；而Lang中间件启动时读Cookie设一次语言，之后再写Cookie也不会触发重载。这两者不是双向同步的。
容易踩的坑：
- 控制器里先
Lang::set('fr-fr')，再cookie('think_lang', 'fr-fr')，结果下一请求还是默认语言——因为Cookie写成功了，但当前请求已过中间件阶段，Lang没重初始化 - 在
Lang中间件运行前调Lang::set()（比如在AppInit钩子），会被中间件里的detect()覆盖掉
稳妥做法：
- 切换语言时，统一用
Lang::set($lang)+cookie('think_lang', $lang)两步 - 避免在中间件外提前调
Lang::set()，除非你清楚当前生命周期阶段 - 调试时可临时加
dump(Lang::getLangSet())确认最终生效的是哪个值
语言包动态加载看着简单，但Cookie键名、中间件注册、目录大小写、设置时机这四点只要漏一个，就卡在“明明设了却不生效”的死循环里。
