ThinkPHP语言切换需在语言包加载前执行，核心是控制语言决定者、读取源和覆盖逻辑；须自定义中间件按Session→Cookie→IP顺序探测并校验合法性，调用Lang::setLang()设置，禁用URL参数切换并统一走API接口。
ThinkPHP 的语言切换参数不能仅靠配置文件“写完就生效”，关键在于切换逻辑必须在语言包加载前执行，否则验证提示、系统错误、模板默认文本等仍会沿用初始语言。自定义切换参数的核心是控制“谁来决定语言”“从哪读取”“怎么覆盖默认行为”。
修改语言来源优先级
默认情况下，ThinkPHP 会按顺序检查 URL 参数（lang=xx）、浏览器 Accept-Language，再缓存到 Cookie。如需自定义来源顺序，例如：优先读 Session → 其次读 Cookie → 最后 fallback 到 IP 地理位置或浏览器头，需在中间件中手动实现：
- 在
app/middleware/Lang.php的handle()方法中，依次读取：$request->session('lang')、$request->cookie('think_lang')、$this->getLangByIP($request->ip())（自定义方法） - 每一步都做合法性校验：
in_array($lang, config('lang_list'))，非法值立即 fallback 到config('default_lang') - 确认最终语言后，立刻调用
\think\Lang::setLang($lang)，且必须在任何lang()或视图渲染前执行
重写语言探测逻辑
ThinkPHP 的 Lang::detect() 默认只识别 $_GET['lang'] 和 HTTP_ACCEPT_LANGUAGE，不读 Session/Cookie。若想让它支持自定义字段（比如用户设置里存的 user_preferred_lang），可重写探测方法：
- 新建一个服务类，例如
app/service/LanguageDetector.php - 在其中封装完整判断链：查数据库用户表字段 → 查 Session → 查 Cookie → 查 Header → 查 IP → 返回 fallback 语言
- 在 Lang 中间件中调用该服务，而非直接用
Lang::detect()
自定义语言标识映射规则
浏览器发送的 Accept-Language: zh-CN,zh;q=0.9,en;q=0.8 解析后是 zh-CN，但你的语言包目录名必须是小写 zh-cn。如果要支持更灵活的映射（比如把 zh-Hans 映射为 zh-cn，en-GB 映射为 en-us），可在中间件中加一层转换：
立即学习“PHP免费学习笔记（深入）”；
- 读取原始语言标识后，用数组映射：
$map = ['zh-hans' => 'zh-cn', 'en-gb' => 'en-us', 'ja' => 'ja-jp']; $lang = $map[strtolower($raw)] ?? $raw;- 再校验是否在
lang_list中，避免无效语言被传入setLang()
禁用默认 URL 切换并接管控制权
很多项目要求禁止通过 ?lang=en-us 切换语言（防止被恶意构造链接劫持），这时必须显式关闭该通道：
- 在
config/app.php中设'allow_url_lang' => false（注意是布尔false，不是字符串） - 同时确保中间件中不再解析
$request->param('lang')，否则逻辑冲突 - 前端切换统一走接口（如
POST /api/lang/switch），后端存 Session + 写 Cookie，并返回成功状态
