ThinkPHP语言侦测通过组合开关实现，需先启用多语言与自动侦测，再按需开启GET、Cookie、Header、Accept-Language四种渠道；默认顺序不可改，但各渠道可独立关闭，且语言标识须在lang_list范围内才生效。
ThinkPHP 的语言侦测开关不是单一布尔值配置，而是通过组合启用、指定来源优先级和控制各渠道开关来实现的。核心在于开启自动侦测机制，并按需启用或禁用 GET、Cookie、Header、Accept-Language 四种识别方式。
1. 启用多语言与自动侦测基础
必须先全局开启多语言功能，并激活自动侦测行为：
-
ThinkPHP 6.x：在
config/lang.php中设置'lang_switch_on' => true（或'lang_switch_on' => true）；'default_lang' => 'zh-cn'；'lang_list' => ['zh-cn', 'en-us'] -
ThinkPHP 5.x：同样在
config/lang.php中配置'lang_switch_on' => true和'lang_list'，并确保应用启动时调用了\think\Lang::detect()（通常在公共文件或中间件中）
2. 控制各侦测渠道的开关
系统默认按固定顺序侦测：GET 参数 → Cookie → Header → HTTP_ACCEPT_LANGUAGE，该顺序不可更改，但每个环节可独立关闭：
-
关闭 GET 识别：不设
'detect_var'，或设为null/ 空字符串（如'detect_var' => ''），则忽略?lang=en-us这类参数 -
关闭 Cookie 记录：设
'use_cookie' => false，这样即使用户切换过语言，也不会存 Cookie，下次访问也不再继承 -
关闭 Header 识别：设
'header_var' => null或留空，前端发送think-lang: en-us将被忽略 -
关闭 Accept-Language 自动匹配：无法完全禁用底层逻辑，但可通过将
'lang_list'设为仅一个语言（如['zh-cn']），或在'accept_language'映射中不定义对应关系，使其匹配失败后回落到默认语言
3. 实际配置示例（TP6）
以下配置表示：只允许通过 GET 参数 ?lang=xx 切换语言，禁用 Cookie 记忆、Header 和浏览器语言自动识别：
'lang_switch_on' => true, 'default_lang' => 'zh-cn', 'lang_list' => ['zh-cn', 'en-us'], 'detect_var' => 'lang', // ✅ 开启 GET 识别 'use_cookie' => false, // ❌ 关闭 Cookie 'header_var' => null, // ❌ 关闭 Header 'accept_language' => [], // ❌ 清空映射，使 Accept-Language 失效
4. 注意事项
语言侦测是否生效，还取决于两点：
- 请求时传入的语言标识（如
en-us）必须在'lang_list'配置范围内，否则会被忽略，回落到'default_lang' - 若使用了自定义中间件或手动调用
Lang::range()，会覆盖自动侦测结果——此时侦测“开了也等于没开”
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
