小程序请求不带accept-language头，thinkphp默认语言探测失效，必须在中间件首行显式调用lang::setlang($lang)并校验白名单，否则lang()始终返回默认语言。
小程序里用 ThinkPHP 做后端，多语言不能靠 URL 参数自动切换，必须手动控制语言上下文，否则 lang() 返回的永远是默认语言。
lang() 在小程序请求中为什么总返回中文？
小程序发起的请求不带浏览器 Accept-Language 头，也不走 ThinkPHP 默认的 Lang::detect() 逻辑（它只看 $_GET['lang'] 和 HTTP_ACCEPT_LANGUAGE）；同时，小程序通常用 cookie 或 token 传用户偏好，但 ThinkPHP 不会自动从这些地方读取语言设置。
- 确认
app.lang_switch_on已设为true，否则整个多语言机制被禁用 - 不要依赖
?lang=en-us—— 小程序 request 的url一般由后端拼接，前端很少主动加参数 - 必须在中间件中显式调用
Lang::setLang($lang)，且该中间件要排在所有业务逻辑之前 - 推荐从请求头读取，比如小程序传
X-Client-Lang: en-us，比解析 token 更轻量、更可控
如何在中间件中安全地设置语言？
关键不是“能不能设”，而是“什么时候设、设完还来得及吗”。Lang 类一旦初始化并加载过语言包，再调 setLang() 也不会重载键值 —— 所以必须抢在第一次 lang() 调用前完成。
- 中间件类名建议叫
AppMiddleware\Lang，注册在app/middleware.php的最顶部 - 从 header 取值：
$lang = $request->header('X-Client-Lang', 'zh-cn')；若用 token 解析，确保解密逻辑无异常，失败时 fallback 到default_lang - 加一层白名单校验：
in_array($lang, ['zh-cn', 'en-us', 'ja-jp']) || $lang = config('app.default_lang')，避免非法语言码导致空包加载 - 调用
\think\Lang::setLang($lang)后，可立即用\think\Lang::getLangSet()验证是否生效
小程序接口返回的错误信息怎么按语言翻译？
错误文案不能硬编码在 return json(['msg' => '用户名不得为空']) 里，而要统一走 lang()，否则无法适配。但要注意：模型验证、系统异常、数据库错误等场景下，lang() 可能尚未就绪或上下文错乱。
- 控制器内所有
return json()的msg字段，一律用lang('require_name')而非字符串字面量 - 模型验证规则里的提示语，写成
['require_name' => ':attribute不得为空']，然后在语言包中定义'require_name' => '用户名不得为空！'，这样:attribute会被自动替换 - 全局异常处理（
app/exception/Handle.php）中，需手动重新设置语言：Lang::setLang($request->header('X-Client-Lang', config('app.default_lang')))，否则捕获到的异常仍用默认语言 - 避免在
__construct()或initialize()中调lang()—— 此时中间件还没执行，语言未设置
小程序多语言和 Web 端能共用一套语言包吗？
可以，但路径和加载方式要一致。小程序后端和 H5 后端本质是同一套 ThinkPHP 应用，只要语言包结构合规，就能复用。
- 语言包必须放在
lang/zh-cn.php、lang/en-us.php这种标准路径下，不能放app/lang/或config/lang.php - 如果小程序和 Web 共享 session，注意
Lang::setLang()是单次请求有效，不会污染其他请求 —— 每次请求都独立设置，无需担心并发冲突 - 不要在语言包里写 PHP 动态逻辑（如
date('Y')），小程序接口返回的是 JSON，无法执行服务端 PHP - 上线前用
Lang::range()检查当前请求已加载的语言键，确认require_name等关键 key 是否存在，避免静默返回原 key 字符串
最容易被忽略的是：小程序请求没触发 ThinkPHP 的语言自动探测流程，你写的 lang('xxx') 看似调用了，其实一直在用 default_lang 的缓存包 —— 所以必须亲手把 setLang() 塞进中间件第一行，别指望框架替你猜。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
