ThinkPHP 的 URL 切语言需确保 allow_url_lang 开启、禁用中间件/控制器中手动设语言、语言包路径规范且模板用 {:lang()}；多语言共存时须在中间件开头统一决策并清空 Lang 缓存。
URL 切语言在 ThinkPHP 里默认能用，但**极易和域名切换、中间件顺序、语言包加载时机冲突**，导致切了没反应、切错语言、或只切了部分文本。关键不是“能不能”，而是“在哪设、谁先谁后、怎么防覆盖”。
为什么 ?lang=en-us 不生效或被忽略
最常见原因是 allow_url_lang 配置没开，或者开了但被其他逻辑覆盖：
-
config/app.php中'allow_url_lang' => false—— 直接禁用 URL 参数识别，?lang=xx完全不解析 - 开了
allow_url_lang，但你在中间件或控制器里手动调了Lang::setLocale('zh-cn')，它会覆盖 URL 解析结果 - 用了多域名方案却没关 URL 参数，
ja.example.com?lang=zh-cn会强制切中文，违背域名本意 - URL 参数名不是
lang（比如配成了l），但前端仍传?lang=en，自然不匹配
如何让 ?lang=xx 真正触发语言切换
必须确保三点：参数被识别 → 语言被设置 → 语言包被重载。ThinkPHP 默认只做到前两步，第三步依赖加载时机：
- 确认
config/app.php中'allow_url_lang' => true且'lang_param' => 'lang'（后者可改，但前后端要一致） - 禁止在控制器中调用
Lang::setLocale()或Config::set('lang.default_lang', ...)，否则会干扰 URL 自动识别 - 语言包必须按标准路径组织：
lang/zh-cn/common.php、lang/en-us/common.php，键名完全一致 - 模板中别写死文字，一律用
{__('hello')}或{:lang('hello')}，否则切换无效
URL 切换 + 域名切换共存时的坑
两者天然冲突，ThinkPHP 不提供优先级配置，必须手动干预：
立即学习“PHP免费学习笔记（深入）”；
- 若以域名为主（如
en.example.com永远英文），必须关掉 URL 参数：'allow_url_lang' => false - 若要保留 URL 切换能力（比如用户点按钮切语言），就得重写语言探测逻辑，在
app\common.php或中间件开头加：
if (isset($_GET['lang']) && in_array($_GET['lang'], config('lang_list'))) {
Config::set('lang.default_lang', $_GET['lang']);
} else {
// 回退到域名映射
$host = parse_url($_SERVER['HTTP_HOST'], PHP_URL_HOST);
$langMap = require config_path('lang_domains.php');
$defaultLang = $langMap[$host] ?? config('lang.default_lang');
Config::set('lang.default_lang', $defaultLang);
}
- 注意：这段代码必须在任何语言包加载前执行，放在
app\middleware.php的全局中间件handle()最开头最稳妥
lang() 和 __() 函数为啥有时不更新
不是函数问题，是语言包已加载完毕：
-
Lang类在应用初始化阶段就加载了default_lang对应的语言包，后续再改default_lang只影响新加载项 -
lang('error.required')这类验证提示，来自框架内置语言包，路径为think/lang/zh-cn.php，它在验证器实例化时就固定了 - 真正可靠的切换方式，是在请求入口（中间件）完成语言设置后，**立刻清空 Lang 实例缓存**：
Lang::clear(); - 或者更彻底：把语言切换逻辑提到
app\provider.php的think\App::init()阶段之前
多语言最麻烦的从来不是“怎么写”，而是“什么时候写”——早了 host 拿不到，晚了语言包已锁死。域名、URL、Session 三者混用时，务必统一在中间件第一行做决策，之后不再碰 Config::set('lang.*')。
