ThinkPHP API多语言需显式设置语言上下文并统一错误码与语言键：通过lang参数、请求头或中间件设语言，严格遵循lang包路径/命名规则，配合error_code配置实现提示文本动态切换。
ThinkPHP 的多语言在 API 场景下不能直接套用模板渲染那一套，lang() 函数本身可用，但关键在于「语言上下文如何确定」和「错误码/提示文本是否走同一套机制」——这两点不处理好，API 返回的中文提示就永远切不到英文。
API 请求里怎么让 lang() 知道该用哪门语言
ThinkPHP 默认靠 GET 参数、Cookie、Accept-Language 头三级 fallback 判断语言，但纯 API（尤其前后端分离）往往不带 Cookie，也不走浏览器自动头解析。这时候必须显式干预。
- 确保
config/lang.php中启用了'lang_detect_var' => 'lang'（或你自定义的参数名），否则?lang=en-us不生效 - 如果前端用
Authorization+ JSON body，GET参数不可靠，就得在中间件里手动设语言：use think\facade\Lang; Lang::setLang($request->header('X-Language', 'zh-cn')); -
Accept-Language解析默认只认zh-CN→zh-cn映射，若前端传zh-Hans，得在config/lang.php的'accept_language'配置里补上：'zh-hans' => 'zh-cn'
lang() 在 JSON 接口里返回乱码或空字符串
常见不是函数问题，而是语言包没加载或路径错位。ThinkPHP6+ 的 lang/ 目录位置和命名规则比 ThinkPHP5 更严格。
- 语言包必须放在
app/lang/zh-cn.php（单应用）或app/api/lang/zh-cn.php（模块化），不能放config/lang.php里 - 文件名必须全小写、用短横线，
zh_CN.php或en_US.php会被完全忽略，不报错也不加载 - 每个语言文件必须
return一个数组，且不能有 BOM 头 —— Windows 编辑器保存时选「UTF-8 无 BOM」 - 如果用了分组（如
user.php），调用时得写lang('user.login_failed')，而不是只写lang('login_failed')
错误码统一管理 + 多语言提示怎么串起来
直接在控制器里写 lang('user_not_found') 可以，但不利于维护。推荐把错误码和语言键解耦：
立即学习“PHP免费学习笔记（深入）”；
- 建
config/error_code.php，内容类似：return [ 'USER_NOT_FOUND' => 1001, 'INVALID_TOKEN' => 1002, ]; - 建
lang/zh-cn.php和lang/en-us.php，都包含：return [ 'USER_NOT_FOUND' => '用户不存在', 'INVALID_TOKEN' => '令牌无效', ]; - 封装响应函数时，用
lang($code)替代硬编码：function api_fail(string $code, array $data = []): array { return [ 'code' => config('error_code')[$code] ?? 500, 'msg' => lang($code), 'data' => $data, ]; }
最易被忽略的是：语言包加载时机。如果在中间件里调 Lang::setLang() 太晚（比如在控制器之后），lang() 已经用默认语言执行过了。务必把语言设置逻辑放在 LoadLangPack 中间件之前，或自己注册一个高优先级中间件。
