ThinkPHP伪静态下lang参数取不到，是因为重写规则未透传查询字符串（如缺失QSA标志或Nginx未拼接$args），且PATH_INFO模式下lang不能嵌入路径而须作为独立GET参数；Lang中间件还需手动解析$request->param('lang')并调用setLang()，同时语言包路径、命名及加载时机必须严格符合框架规范。
ThinkPHP 多语言配置本身不依赖伪静态，但两者在 URL 表现和请求处理上存在隐性耦合：伪静态规则若未正确保留 lang 参数或干扰 PATH_INFO 解析，会导致 Lang::detect() 无法从 URL 获取 lang 值，进而使语言切换失效。
lang 参数在伪静态下为什么取不到
ThinkPHP 默认通过 $_GET['lang'] 检测语言（当 lang_switch_on => true 时）。但伪静态重写后，原始查询参数可能被剥离或未透传。
- Apache 的
RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]中QSA（Query String Append）必须存在，否则?lang=en-us会被丢弃 - Nginx 的
try_files $uri $uri/ /index.php?s=$uri&$args;中$args必须显式拼接，漏掉就等于丢掉所有 GET 参数 - 如果用的是
index.php/<path></path>格式（PATH_INFO 模式），lang必须作为独立参数传入，不能混在 path 里，例如/zh-cn/user/login不会触发 lang 切换，而/user/login?lang=zh-cn才会
Lang 中间件注册后仍不生效的常见链路断点
Lang 中间件执行时机早于控制器，但若注册位置错误或加载顺序不对，Lang::setLang() 就没机会在翻译前生效。
- 确认中间件已加入
app/middleware.php的全局数组，而不是只写在某个路由组里 - 检查是否与其他中间件冲突，比如自定义的「URL 解析中间件」提前修改了
$request，导致后续Lang::detect()读不到原始$_GET - TP6+ 中，
think\middleware\Lang类默认只响应Accept-Language和配置项，不解析 URL 参数——要手动扩展，例如在中间件 handle 方法中加：$lang = $request->param('lang', $request->session('lang', config('app.default_lang'))); \think\Lang::setLang($lang); - 调用
Lang::setLang()后，必须确保后续无重复设置，否则后设的会覆盖前设的
语言包路径和命名被忽略的硬性约束
ThinkPHP 对语言包路径、文件名、返回格式有严格约定，任意一项不符都会静默失败——不报错，只返回原 key 字符串。
立即学习“PHP免费学习笔记（深入）”；
- 语言包必须放在
app/lang/{lang}/common.php，其中{lang}是小写连字符格式（如zh-cn），不是zh_CN或ZH-CN -
common.php必须以return ['key' => 'value'];结尾，不能是echo、print、BOM 头、多余空格或 JSON 格式 - 模块级语言包路径为
app/module/lang/{lang}/common.php，优先级高于应用级，但需确保模块名拼写与路由一致（如admin模块不能写成Admin） - Linux 服务器上大小写敏感，
lang/zh-cn/common.php和lang/ZH-CN/common.php是两个不同路径
最易被忽略的其实是「语言包加载时机」：Lang 中间件设完语言后，框架自动加载对应语言包；但如果在中间件里调用了 lang()，而此时语言包尚未完成加载（比如路径错、文件不存在），就会返回 key 名本身，且线上环境默认不报错——建议上线前用脚本遍历所有 lang() 调用点，比对语言包键名完整性。
