thinkphp多语言需显式配置lang_list等参数且严格校验，仅配置不够还需语言包目录存在、命名规范、文件格式正确；动态限定可用语言可调用lang::setallowlanglist()。
ThinkPHP 支持的语言列表不是靠自动识别或系统内置决定的，而是由你**显式配置并严格校验**的。只要没在配置里写明，哪怕语言包文件存在、浏览器发来 zh-tw 请求，框架也会直接忽略或 fallback 到默认语言。
在 config/app.php 中设置 lang_list
打开 config/app.php，找到或添加以下配置项：
-
'lang_list' => ['zh-cn', 'en-us', 'ja-jp', 'zh-tw'] —— 必须是小写、短横线分隔的字符串数组；不能有空格，不能用下划线或大写（如
zh_TW、ZH-CN都无效） -
'default_lang' => 'zh-cn' —— 必须是
lang_list中的一个值，否则启动时可能报错或静默降级 -
'lang_switch_on' => true —— 布尔值
true，不是字符串'true'，否则整个多语言逻辑不触发
语言列表生效的前提条件
仅配置 lang_list 不够，还需同步满足：
- 对应语言码的目录必须真实存在且命名规范：如
lang/zh-tw/common.php，路径全小写、短横线、子目录名与lang_list项完全一致 - 每个语言包文件（如
common.php）必须以return [...]返回 PHP 数组，不能是 JSON、YAML 或带 BOM 的 UTF-8 文件 - 若使用插件或多模块结构，插件需自建
lang/目录并注册专属中间件，主应用的lang_list对插件无效
可选：运行时动态限定允许语言
如果想在中间件或控制器中临时限制可用语言（比如根据用户角色只开放中英文），可用：
\think\Lang::setAllowLangList(['zh-cn', 'en-us']);
该方法优先级高于配置文件中的 lang_list，但只对当前请求有效；常用于登录后按用户偏好动态收紧语言选项。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
