ThinkPHP多语言在微信小程序中需手动控制切换，因小程序无HTTP_ACCEPT_LANGUAGE头且不自动透传Cookie；LANG_AUTO_DETECT失效，必须通过中间件显式调用Lang::setLang()并结合Session或Token绑定语言偏好。
ThinkPHP 多语言在微信小程序端能用，但必须手动控制语言切换逻辑，不能依赖浏览器自动检测 —— 因为小程序没有 HTTP_ACCEPT_LANGUAGE，也不走 Cookie 自动回传流程。
为什么小程序里 LANG_AUTO_DETECT 基本失效
ThinkPHP 默认的 CheckLangBehavior 行为靠 $_SERVER['HTTP_ACCEPT_LANGUAGE'] 或 URL 参数（如 ?l=en-us）识别语言，而小程序发起的请求不带该 header，且无法复用 Web 端的 Cookie（think_language 不会自动透传）。
- 小程序 wx.request 默认不携带 Cookie，即使后端设了
setcookie()，前端也不会存、不会发 -
Lang::setLang()必须在请求入口（如中间件）中显式调用，且必须早于任何lang()调用 - 语言包加载是单次行为：一旦
zh-cn/common.php加载完成，后续再调用Lang::setLang('en-us')不会重新加载en-us/common.php
小程序语言切换必须走 API + Session/Token 绑定
正确做法是把语言选择当作用户状态来维护，由小程序主动传参，后端用 Session 或 Token 关联语言偏好。
- 小程序登录后，首次请求带上
lang=zh-cn或lang=en-us作为 query 或 header（推荐放 header：X-Language: en-us） - 后端中间件读取该值，调用
\think\Lang::setLang($lang)，并写入 Session：$request->session('lang', $lang) - 后续请求无需重复传，中间件从 Session 读取即可，避免每次都要前端传
- 注意：Session ID 必须由小程序在请求时通过 cookie 或 header 透传（微信小程序默认不发 cookie，需手动用
withCredentials: true+ 后端配置Access-Control-Allow-Credentials: true）
lang/ 目录结构和文件命名必须严格按小写语言码
ThinkPHP 不识别 zh_CN、ZH-CN 或 zh-ch 这类变体，只认标准小写短横分隔格式，且语言包必须是 PHP 返回数组，不是 JSON。
立即学习“PHP免费学习笔记（深入）”；
- 路径必须是
lang/zh-cn/common.php，不能是lang/zh_CN/common.php或lang/zh-cn.php -
common.php必须以return ['login' => '登录'];结尾，不能有 echo、print 或额外输出 - 如果用了模块化（如
app\home），优先加载app\home\lang\zh-cn\common.php，再 fallback 到应用层app\lang\zh-cn\common.php - 调试时开启
app_debug = true，缺失 key 会记日志；线上静默，建议上线前用脚本遍历所有语言包检查 key 对齐
小程序模板里别直接写 lang('xxx')，要封装成接口字段
小程序 WXML 无法执行 PHP 函数，所有多语言文本必须由后端 API 返回，前端只做渲染。
- 错误示范：
lang('submit')写在控制器里返回字符串，但没考虑当前语言上下文是否已生效 - 正确做法：统一在基类控制器或中间件设好语言后，所有接口响应里的文案字段（如
data.button_text）都走lang()动态生成 - 例如：
return json(['code' => 0, 'msg' => lang('login_success'), 'data' => ['title' => lang('welcome')]]) - 避免在模型、验证器等非请求生命周期中调用
lang()，此时语言环境可能未初始化
最易被忽略的一点：语言包加载时机不可逆，Lang::setLang() 必须在框架加载完路由、执行到控制器之前完成，否则已解析的视图或配置里的 lang() 调用会固化为默认语言。中间件顺序和 Session 初始化顺序，比语言包内容本身更关键。
