ThinkPHP 6 多语言失效主因是 Session 初始化过晚：必须在 app/middleware.php 中注册 SessionInit 中间件并置于 Lang 中间件之前，伪静态需通过路由变量获取 lang 并存入 Session，同时显式调用 Session::save() 持久化，且 Cookie 键名须为 think_lang。
Session 初始化太晚，Lang 中间件读不到语言偏好
ThinkPHP 6 默认不自动启动 Session，而 Lang 中间件在请求早期就要读 $_SESSION['lang'] 或 cookie('think_lang') 来加载对应语言包。如果 Session 还没初始化，$_SESSION 就是空的，中间件自然跳过切换逻辑，始终 fallback 到默认语言。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 确认
\think\middleware\SessionInit::class已注册到全局中间件（app/middleware.php），且排在\think\middleware\Lang::class之前 - 不要依赖“中间件里调了
session('lang', 'zh-cn')就算存进去了”——TP6 的 Session 是延迟写入的，必须显式触发保存 - 在设置语言后加一行
\think\facade\Session::save()，否则刷新页面就丢失
伪静态下 lang 参数没进 Session，路由没捕获变量
伪静态把 /index.php?lang=zh-cn 改成 /zh-cn/ 后，$_GET['lang'] 消失了。如果你还在中间件里硬读 $_GET，那永远拿不到值；Lang 中间件也不会自动从 URL 路径里提取语言段。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在
route.php中定义带lang变量的规则，例如：Route::rule('[:lang]/[:any]', 'index/index/index')->pattern(['lang' => '\w+-?\w+']); - 在 Lang 中间件或自定义中间件中用
$request->param('lang')获取，再写入session('lang', $lang) - 生成链接必须用
url()函数，它会自动把当前session('lang')注入路径前缀，避免手拼 URL 导致参数丢失
Session 驱动未显式配置，静默降级为 file 或彻底失效
TP6 不再默认回退到 file 驱动。如果 config/app.php 的 session 数组里没写 'driver' => 'file'，框架连 session_start() 都不调，你写的 session('lang', ...) 全部无效，还不报错。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 检查
config/app.php中'session' => [...]是否包含'driver' => 'file'（或'redis'） - 若用 Redis，必须安装
topthink/think-session扩展，并在redis_config里写全'hostname'、'hostport'、'password'，键名不能照搬 TP5.1 的redis_host - Redis 多项目共用时，
'prefix'必须设非空值（如'admin:'），否则 session key 冲突导致语言状态互相覆盖
Cookie 和 Session 语言标识不同步，Lang 中间件只认 think_lang
很多人前端用 document.cookie = "lang=zh-cn" 写 Cookie，但 TP6 的 Lang 中间件默认只检查 think_lang 这个键。写错了键名，中间件就当没这回事，语言包照旧按浏览器 Accept-Language 加载。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 前端设语言必须用
cookie('think_lang', 'zh-cn')，而不是手写setcookie()或直接操作document.cookie -
Lang::set('zh-cn')只改当前请求上下文，不写 Cookie 也不存 Session，要持久化得自己补session('lang', 'zh-cn')和cookie('think_lang', 'zh-cn') - 确保 Cookie 的
path和domain与后端一致，比如domain设为'.example.com'才能跨子域名共享
