lang::detect() 是 thinkphp 5.1+ 中触发语言自动侦测的核心方法，必须在请求早期显式调用或通过中间件注入，否则即使开启 lang_switch_on 也无效；它仅返回语言标识符（如 'zh-cn'），不自动写 cookie 或加载语言包，需配合 lang::set() 和 loadlangpack 中间件才能生效。
Lang::detect() 是 ThinkPHP 5.1+ 中触发语言自动侦测的核心方法，但它的执行时机和上下文直接影响是否生效——不手动调用或未注册对应中间件时，lang() 函数永远返回默认语言，哪怕配置了 lang_switch_on 也无效。
Lang::detect() 必须在请求生命周期早期执行
ThinkPHP 不会在启动时自动调用语言侦测，它依赖显式触发或中间件注入：
-
Lang::detect()默认只检查$_GET['lang']和$_SERVER['HTTP_ACCEPT_LANGUAGE']，不读取 Cookie（除非你手动从 Cookie 取值再传入） - 它不会自动写入 Cookie 或 Session，只是返回一个语言标识符（如
'zh-cn'），后续需配合Lang::set()才真正切换 - 在控制器中 late 调用（比如
index()方法里）会导致模板、验证器、日志等已加载完毕，语言包无法回溯生效
建议做法：
- 在应用中间件中统一处理，例如
app/middleware.php添加：think\middleware\LoadLangPack::class,
- 或自定义中间件，在
handle()开头调用：$lang = Lang::detect();<br>Lang::set($lang);
伪静态下 lang 参数无法被 $_GET 捕获？
伪静态（如 Nginx 的 rewrite ^/en-us/(.*)$ /index.php?lang=en-us& last;）本身不影响语言侦测逻辑，但容易踩两个坑：
-
VAR_LANGUAGE配置项（TP5.1+ 对应lang_detect_var）必须与 rewrite 规则中的参数名一致；若规则用?lang=en-us，那配置就得是'lang_detect_var' => 'lang'，不能写成'l'或漏配 - rewrite 后的 URL 若未保留原始
Accept-Language头（极少见），浏览器自动侦测会失效，此时只能依赖 URL 参数
验证方式：在控制器中打印 dump(input('get.'));，确认 lang 是否出现在输出里。没有？说明 rewrite 规则没把参数透传给 PHP。
Lang::detect() 返回空字符串的常见原因
这不是 bug，而是校验失败的明确信号：
- 当前语言不在
Lang::getAllowLangList()允许列表中（注意：TP5.1+ 默认不限制，但如果你显式调用了Lang::setAllowLangList(['zh-cn'])，而浏览器报的是zh-Hans，就会被拒） -
$_SERVER['HTTP_ACCEPT_LANGUAGE']为空（某些 CLI 请求、Postman 未设头、CDN 剥离了该 header） -
lang参数值含非法字符（如空格、斜杠、点号），Lang::detect()内部做了基础过滤，不符合/^[a-z]{2}(-[a-z]{2})?$/i格式直接跳过
调试技巧：
dump($_SERVER['HTTP_ACCEPT_LANGUAGE']);<br>dump(input('get.lang'));
比盲猜配置更可靠。
关键点就一句：语言侦测不是“开个开关就自动转”，它是一次性的函数调用行为，且只管“选语言”，不管“加载语言包”——选完必须 Lang::set()，加载还得靠 LoadLangPack 中间件或手动 Lang::load()。漏掉任一环，L('hello') 就永远显示英文或空。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
