ThinkPHP语言切换失效的首要原因是Cookie键名错误，Lang中间件仅识别think_lang，若设为lang、language等则完全跳过切换逻辑；必须严格匹配键名、path=/且域名一致，或改用后端接口设置。
前端按钮点击后语言没变，检查 Cookie 键名是不是 think_lang
ThinkPHP 的 Lang 中间件只认 think_lang 这个 Cookie 名，不是 lang、language，也不是你随便起的名。设错就等于没设，中间件启动时直接跳过切换逻辑。
常见错误现象：
- 前端用
document.cookie = 'lang=ja-jp; path=/'写入，但后端完全无反应 - 浏览器 DevTools 里能看到 Cookie，但
Lang::get()仍返回中文 - 手动 curl 带
Cookie: think-lang=ja-jp却生效——说明键名大小写或拼写错了
正确做法：
- 用 JS 调用后端接口切换（推荐）：
fetch('/setlang?lng=ja-jp')，接口里调cookie('think_lang', 'ja-jp') - 纯前端写 Cookie 必须严格匹配：
document.cookie = 'think_lang=ja-jp; path=/; max-age=31536000' - 确保
path是/（除非你明确限定子路径），且域名一致
lang() 在模板里不生效？确认 Lang 中间件已注册且顺序正确
Lang 中间件默认不启用，不注册就等于没写。它不会报错，但 Lang::get() 返回空或默认语言，非常隐蔽。
立即学习“PHP免费学习笔记（深入）”；
检查点：
- 打开
app/middleware.php，确认think\middleware\Lang::class在数组中，且未被注释 - 多应用模式下，每个应用的
middleware.php都要单独加 - 中间件执行顺序很重要：必须在
SessionInit之后、路由调度之前。否则读不到 Cookie 或 Session
示例正确配置：
return [
\think\middleware\SessionInit::class,
\think\middleware\Lang::class, // 必须紧接在 SessionInit 后
\think\middleware\LoadLangPack::class,
];
前端传 ?lang=ja-jp 但语言还是不变，看 detect_var 配置是否匹配
ThinkPHP 默认从 URL 参数 lang 检测语言，但这个变量名是可配的，由 detect_var 控制。如果改过配置却没同步前端，参数就白传了。
查配置文件 config/lang.php：
- 如果
'detect_var' => 'lang'（默认），前端用?lang=ja-jp就行 - 如果改成
'detect_var' => 'l'，那必须传?l=ja-jp - 该配置只影响 URL 参数识别，不影响 Cookie 或 Header 方式
注意：lang_switch_on 必须为 true，否则整个检测链都不走。
JS 动态切换后页面局部刷新，lang() 仍显示旧语言？别忘了服务端上下文已固定
ThinkPHP 的语言切换发生在请求初始化阶段。JS 点击后发新请求（比如 AJAX 或跳转），服务端才重新跑 Lang 中间件并加载对应语言包。但如果你只是用 JS 改 DOM 文本，服务端根本没参与——那当然不会变。
两种可行路径：
- 整页跳转：
window.location.href = '?lang=ja-jp'，让服务端重渲染 - AJAX 局部更新：后端接口返回翻译后的 JSON 数据（如
{title: '送信', submit: '送信する'}），前端再填入 DOM
不要试图在 JS 里模拟语言包映射——维护成本高、无法复用服务端验证/模型提示等语言逻辑，也绕不开 Cookie 和中间件机制。
最容易被忽略的一点：Lang 中间件只读一次 Cookie，后续 JS 修改 document.cookie 不会触发语言重载，必须发起新 HTTP 请求才能生效。
