Lang中间件需显式配置'use_cookie'=>true才读取Cookie；若关闭则须手动调Lang::set()并加载对应语言包；Cookie的path、domain必须前后端一致；插件应使用独立lang键名避免冲突。
Lang中间件注册了但不读Cookie？检查是否漏配use_cookie
ThinkPHP 6 的 Lang 中间件默认不启用 Cookie 识别，即使你写了 cookie('think_lang', 'en-us')，中间件也完全无视——它只在 'use_cookie' => true 时才去读 $_COOKIE['think_lang']。
常见错误现象：Lang::get('submit') 始终返回默认语言，$_COOKIE['think_lang'] 确实存在，但 Lang::detect() 结果不变。
实操建议：
- 打开
config/lang.php，确认包含'use_cookie' => true（不是注释掉） - 同时核对
'cookie_var' => 'think_lang'是否与你写入的键名一致（比如前端用document.cookie = 'lang=zh-cn'就无效） - 若项目启用了多应用，需在对应应用目录下的
config/lang.php单独配置，主配置不继承
关闭use_cookie后想手动切换语言？必须显式调Lang::set()并重载包
一旦 'use_cookie' => false，Lang 中间件就只依赖 GET 参数或 Header，不再碰 Cookie。此时想靠接口或按钮切换语言，不能只改 Cookie，必须主动触发语言上下文重置。
立即学习“PHP免费学习笔记（深入）”；
关键点在于：Lang::set('ja-jp') 只改当前请求的语言标识，但不会自动加载 lang/ja-jp/common.php——如果该路径下没有有效语言包，Lang::get() 仍回退到默认值，且不报错。
实操建议：
- 切换前先确认语言包存在：
lang/ja-jp/common.php必须是小写短横线命名、文件内容为return ['key' => 'value']; - 在控制器中执行切换逻辑时，按顺序写：
Lang::set($lang); Lang::load(app()->getBasePath() . 'lang/' . $lang . '/common.php'); - 若使用模块化语言包（如
admin/common.php），Lang::load()需补全路径，不能只靠Lang::set()
前端改了think_lang Cookie但刷新后失效？检查path和domain是否匹配
Cookie 的 path 和 domain 不匹配，会导致 PHP 写入的 Cookie 和 JS 读取/写入的 Cookie 实际是两个不同作用域的实体——页面刷新后“消失”，其实是根本没发到服务端。
典型表现：Chrome DevTools 的 Application → Cookies 里能看到 think_lang，但 $_COOKIE['think_lang'] 为空；或者本地开发正常，上线后失效。
实操建议：
- 后端写 Cookie 时显式指定作用域：
cookie('think_lang', 'en-us', ['path' => '/', 'domain' => '.example.com']) - 前端用
document.cookie写时，path和domain必须与后端完全一致（注意domain开头的点号） - 反向代理环境下（如 Nginx 终止 HTTPS），需在
config/app.php的cookie配置中强制设'secure' => true，否则浏览器可能拒绝发送带 Secure 标志的 Cookie
插件内语言切换独立于主站？别碰think_lang，改用plugin_xxx_lang
插件要实现语言隔离，直接复用 think_lang 会污染主站语言状态。官方 Lang 中间件只认这个键，所以插件必须绕过它，自己接管语言设置流程。
核心矛盾点：插件控制器执行前，主站 Lang 中间件已经完成语言初始化，再调 Lang::set() 已晚——模板、验证器里的 lang() 全按主站语言渲染完了。
实操建议：
- 插件自建中间件（如
middleware/LangSwitch.php），在handle()开头就读取专属 Cookie：$request->cookie('plugin_wechat_lang', 'zh-cn') - 立刻执行
Lang::set($lang)，这一步必须早于任何插件内lang()调用 - 插件语言包路径必须独立：如
app/plugin/WechatPay/lang/zh-cn/common.php，不能指望主站app/lang/ - 前端切换按钮只能操作
plugin_wechat_lang，绝对不要动think_lang，否则整个站点语言都会被拖走
最易被忽略的是中间件执行时机和语言包路径大小写——Linux 服务器上 lang/ZH-CN/ 和 lang/zh-cn/ 是两个目录，本地 Windows 测试通过，上线就静默失败。
