ThinkPHP控制器中切换语言需先调用Lang::set()设置当前请求语言标识，再通过Cookie或Session持久化用户偏好，确保下次请求自动加载对应语言包。
在 ThinkPHP 中，控制器内切换语言不是靠“切换”动作本身，而是靠提前设定当前请求的语言标识。关键在于：语言包加载发生在请求早期（通常由中间件完成），一旦加载完成，lang() 函数就固定使用该语言上下文。所以控制器里调用 Lang::set() 只影响本次请求后续的 lang() 调用，但不会重载已加载的语言包内容（比如验证提示、模板中已解析的字符串）。
因此，控制器中“切换语言”的实际含义是：
- 立即生效当前请求的语言上下文（用于后续
lang()） - 同时持久化选择（写 Cookie 或 Session），让下一次请求也按此语言加载
H3 设置当前请求语言（必须在语言包加载后仍有效）
use think\Lang;
// 在控制器方法开头或需要切换逻辑的位置执行
Lang::set('en-us'); // 立即切换当前请求语言为英文⚠️ 注意：
- 这行代码必须在任何
lang()调用之前执行，否则已渲染的模板或验证错误仍显示旧语言。 - 它只改内存中的语言标识，不写 Cookie，不存 Session，刷新页面就失效。
H3 同时保存用户偏好（推荐组合使用）
控制器中切换语言，通常要同步更新存储介质，确保下次访问自动沿用：
立即学习“PHP免费学习笔记（深入）”；
use think\Cookie;
use think\Session;
use think\Lang;
public function switchLang($lang = 'zh-cn')
{
// 1. 校验语言是否合法
$allowLangs = config('lang_list', ['zh-cn', 'en-us']);
if (!in_array($lang, $allowLangs)) {
$lang = config('default_lang', 'zh-cn');
}
// 2. 设定当前请求语言（影响后续 lang()）
Lang::set($lang);
// 3. 持久化：写入 Cookie（推荐，跨请求稳定）
Cookie::set('think_lang', $lang, [
'expire' => 31536000, // 1年
'path' => '/',
'domain' => '', // 留空或填主域名，需与中间件读取时一致
]);
// ✅ 可选：也存入 Session（适合登录态强绑定场景）
// Session::set('lang', $lang);
// 4. 跳转回原页或返回成功
return redirect()->back();
}? 前端可这样触发：
<a href="%7B:url('switchLang',%20['lang'=>'en-us'])%7D">English</a>
H3 插件内控制器切换语言（独立插件场景）
如果你在插件（如 app/plugin/WechatPay）中操作，不能依赖主应用的 think_lang，否则会干扰全站：
use think\Cookie;
use think\Lang;
public function setPluginLang($lang = 'zh-cn')
{
$valid = in_array($lang, ['zh-cn', 'en-us', 'ja-jp']);
$lang = $valid ? $lang : 'zh-cn';
// 写插件专属 Cookie（前缀隔离）
Cookie::set('plugin_wechat_lang', $lang, [
'path' => '/',
'expire' => 31536000,
'domain' => config('cookie.domain', ''),
]);
// 当前请求立即生效（注意：插件需已注册 LangSwitch 中间件）
Lang::set($lang);
return json(['code' => 0, 'msg' => 'ok']);
}✅ 前提：插件已配置专属中间件，在控制器执行前就通过 Cookie::get('plugin_wechat_lang') 调用了 Lang::set()。
H3 不推荐的做法（常见误区）
- ❌ 在控制器里只写
Cookie::set('lang', 'en-us')—— ThinkPHP 默认不读lang，只认think_lang - ❌ 调用
Lang::load()手动加载新语言包 —— 多余且易错，框架自动按Lang::getLangSet()加载对应目录 - ❌ 在模板里用
{php}Lang::set('en-us'){/php}—— 模板编译后执行太晚，语言包早已加载完毕
不复杂但容易忽略：控制器里 Lang::set() 是“补救”或“微调”，真正的语言初始化应交给中间件完成。
