ThinkPHP多语言生效需严格匹配语言包路径、加载时机和Lang::setLang()调用位置；伪静态路由下必须在中间件前端从路由变量提取语言码并设置，否则因翻译函数提前执行而失效。
ThinkPHP 多语言扩展不是靠“加个插件”或“改个配置”就能生效的，核心在于语言包路径、加载时机和 Lang::setLang() 的调用位置是否严格匹配框架机制。伪静态路由下语言切换失效，90% 是因为语言设置被延迟到了控制器里，而翻译函数已在视图或中间件前置逻辑中提前执行。
lang/ 目录结构和文件命名必须严格小写+短横线
语言包必须放在项目根目录下的 lang/ 子目录，不能是 config/lang.php 或 extend/lang/；每个语言子目录名必须全小写且用短横线分隔，例如 zh-cn、en-us，zh_CN 或 ZH-CN 在 Linux 服务器上直接不加载，且无任何报错提示。
-
lang/zh-cn/common.php必须以return ['hello' => '你好'];形式返回数组，不能是 JSON、YAML 或 echo 输出 - 若使用分组（如用户模块专用语言），可建
lang/zh-cn/user.php，但调用时需显式指定：lang('login', [], 'user') - 模块级语言包优先级高于应用级：
app\index\lang\zh-cn\common.php>lang/zh-cn/common.php
伪静态路由下如何让 lang= 参数被正确识别
当 URL 是 /zh-cn/article/123 这类伪静态形式时，Lang::detect() 默认不解析路径段，它只看 $_GET['lang'] 和 Accept-Language 头。必须手动从路由变量中提取语言码，并在中间件最前端完成设置。
- 定义带语言前缀的路由：
Route::get(':lang/article/:id', 'Article/read')->pattern(['lang' => '[a-z]{2}-[a-z]{2}']); - 在中间件中读取并设置：
$lang = $request->route('lang', config('app.default_lang'));，然后立即调用\think\Lang::setLang($lang) - 切勿在控制器构造函数或
initialize()中调用setLang()，此时语言包可能已被缓存或部分加载 - 如果用了多级模块（如
admin模块），需确保该模块的lang/目录存在且结构一致，否则 fallback 到应用级语言包
lang() 函数占位符和复数语法的边界情况
lang() 支持 {key} 占位符和 item|items 复数语法，但规则极简，不兼容 gettext 风格，也无自动类型推导。
立即学习“PHP免费学习笔记（深入）”；
- 占位符只认花括号格式：
lang('welcome', ['name' => 'Tom'])→ 语言包中对应'welcome' => '欢迎 {name}'，写成:name或%s会原样输出 - 复数判断仅依赖数值本身：
lang('message|messages', 1)取左边，lang('message|messages', 0)或2都取右边，不区分 0/1/其他 - key 不存在时默认返回原字符串（如
lang('missing')返回'missing'），线上环境不会报错也不会记录，容易误判——建议上线前用脚本比对所有模板中出现的 key 和语言包键名 - 调试模式下缺失 key 会记入日志，但仅限
runtime/log/，不抛异常，也不中断流程
最容易被忽略的是：语言包一旦在某次请求中被加载（比如第一次调用 lang()），后续再调用 Lang::setLang() 不会重载已加载的语言项。所以语言切换必须在任何 lang() 调用之前完成，哪怕只是 view 模板里的 {:lang('xxx')}，也算一次调用。
